TokenLab

Fichiers & lots

Créer un lot (Batch)

Créer un lot à partir d'un fichier JSONL téléchargé.

POST
/v1/batches

Aperçu

Téléchargez un fichier JSONL avec purpose=batch, puis utilisez son ID comme input_file_id. Les lots terminés renvoient les ID des fichiers de sortie et d'erreur.

Remarques

  • Les fichiers d'entrée de lot doivent utiliser purpose=batch.
  • completion_window est actuellement de 24h.
  • L'ordre de sortie peut différer de l'ordre d'entrée. Faites correspondre chaque résultat via custom_id.
  • Le streaming n'est pas pris en charge au sein des éléments de lot.
  • Les endpoints d'éléments pris en charge 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"
  }'

Les tarifs des lots peuvent différer des requêtes synchrones. Utilisez le prix indiqué lors de la création du lot et de la facturation finale.

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
ID du lot.
statusstring
Statut du lot.
output_file_idstring|null
ID du fichier de sortie après exécution.

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