TokenLab

Fichiers & lots

Créer un lot

Crée un travail de lot compatible avec OpenAI à partir d'un fichier d'entrée téléchargé.

POST
/v1/batches

Aperçu

Ce point de terminaison fait partie de l'API de lot 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 renvoyer 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.
  • Les points de terminaison pris en charge pour les éléments de lot sont /v1/chat/completions et /v1/embeddings. /v1/responses n’est pas pris en charge.

Exemple

Requête

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

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",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Champs importants

idstring
Identifiant pour les appels suivants et le support.
statusstring
État de cycle de vie actuel de cette ressource.
output_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

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json

application/json