> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer le lot

> Récupère le statut actuel, les comptes et les fichiers de résultats pour un lot.

## Aperçu

Cet endpoint fait partie de l'API Batch compatible avec OpenAI de TokenLab. Les travaux de lot utilisent des fichiers JSONL téléchargés, s'exécutent de manière asynchrone et peuvent retourner des fichiers de sortie/d'erreur plus tard.

## Remarques

* Les fichiers d'entrée de lot doivent utiliser `purpose=batch`.
* `completion_window` est actuellement `24h`.
* L'ordre de sortie n'est pas garanti ; faites toujours correspondre par `custom_id`.
* Le streaming n'est pas pris en charge à l'intérieur des éléments de lot.

## Exemple

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

## Demande / Réponse

Utilisez le panneau OpenAPI interactif ci-dessus pour le schéma exact.

## Conseils opérationnels

* Utilisez `custom_id` pour la réconciliation idempotente en aval.
* Attendez-vous à ce que `output_file_id` et `error_file_id` ne soient disponibles qu'après que le travailleur finalise le lot.
* La tarification des lots peut différer de la tarification synchrone car les règles de réduction `isBatchRequest=true` s'appliquent.

## Exemple de réponse

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "batch_abc123",
    "object": "batch",
    "status": "completed",
    "input_file_id": "file_abc123",
    "output_file_id": "file_out123",
    "error_file_id": null,
    "request_counts": { "total": 100, "completed": 98, "failed": 2 }
  }
  ```
</ResponseExample>

## Champs importants

<ResponseField name="request_counts" type="object">Liste ou payload retourné par cette réponse.</ResponseField>
<ResponseField name="output_file_id" type="string|null">Identifiant de fichier utilisé par les API liées.</ResponseField>
<ResponseField name="error_file_id" type="string|null">Identifiant de fichier utilisé par les API liées.</ResponseField>