> ## 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 fichier

> Récupère les métadonnées d’un seul fichier téléversé.

## Aperçu

Ce point de terminaison sert principalement les objets de fichier de l’API Batch compatible avec OpenAI de TokenLab.

Lorsque la requête active le mode de compatibilité Anthropic Files, la même route peut aussi renvoyer des métadonnées de fichier de style Anthropic pour l’espace de travail lié.

Sans en-têtes Anthropic, cette route peut renvoyer un objet de fichier de lot ou un objet de fichier image/référence TokenLab.

## Remarques

* Les fichiers d'entrée de lot doivent utiliser `purpose=batch`.
* Utilisez `purpose=batch_output` pour vous concentrer sur les fichiers de sortie générés.
* `completion_window` est actuellement `24h`.
* L'ordre de sortie n'est pas garanti ; il faut toujours faire 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/files/file_abc123" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

## Requête / 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 remise `isBatchRequest=true` s'appliquent.

## Exemple de réponse

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "file_abc123",
    "object": "file",
    "bytes": 32768,
    "created_at": 1706000000,
    "filename": "batch-input.jsonl",
    "purpose": "batch"
  }
  ```
</ResponseExample>

## Champs importants

<ResponseField name="id" type="string">Identifiant de fichier utilisé par les API liées.</ResponseField>
<ResponseField name="filename" type="string">Nom de fichier d’origine ou généré.</ResponseField>
<ResponseField name="purpose" type="string">Finalité du fichier utilisée par le workflow propriétaire, par exemple `batch`, `batch_output`, `user_data` ou `vision`.</ResponseField>