TokenLab

Fichiers & lots

Récupérer le lot

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

GET
/v1/batches/{batch_id}

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

Requête

cURL
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

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.

Exemple de réponse

Réponse

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "status": "completed",
  "input_file_id": "file_abc123",
  "output_file_id": "file_out123",
  "error_file_id": "file_err123",
  "request_counts": { "total": 100, "completed": 98, "failed": 2 }
}

Champs importants

request_countsobject
Nombre total de requêtes, ainsi que les requêtes réussies, échouées et annulées.
output_file_idstring|null
Identifiant de fichier utilisé par les API liées.
error_file_idstring|null
Identifiant de fichier utilisé par les API liées.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

batch_id*string

Réponse

application/json

application/json