Passer au contenu principal

​
Aperçu

Ce point de terminaison fait partie de l’API Batch compatible avec OpenAI de TokenLab. Les travaux en 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.

​
Modes de fichier pris en charge

TokenLab traite /v1/files comme trois modes explicites :
  • Fichiers de lot : utilisez purpose=batch pour /v1/batches.
  • Fichiers image/référence : utilisez purpose=user_data ou purpose=vision pour les requêtes image basées sur fichier.
  • Mode Anthropic Files API : ajoutez anthropic-beta: files-api-2025-04-14 pour le stockage de fichiers natif Anthropic.

​
Remarques

  • Les fichiers d’entrée en 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

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

​
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 remise isBatchRequest=true s’appliquent.

​
Entrées de fichiers image

Cette même route /v1/files peut aussi téléverser des fichiers image de référence pour /v1/images/edits.
  • Utilisez purpose=user_data ou purpose=vision.
  • Ajoutez éventuellement model pour choisir le modèle d’édition d’image ; la valeur par défaut est gpt-image-2.
  • Le file_id renvoyé est lié au canal amont d’édition d’image sélectionné et peut être réutilisé dans images[].file_id.

​
Mode Anthropic Files API

Cette même route /v1/files prend aussi en charge le chemin Anthropic Files API.
  • Ajoutez l’en-tête anthropic-beta: files-api-2025-04-14 pour basculer en mode Anthropic.
  • En mode Anthropic, chargez directement le fichier d’origine et n’envoyez pas purpose=batch.
  • Le file_id renvoyé est lié au même canal/workspace Anthropic officiel et doit être réutilisé dans les requêtes /v1/messages.
  • Si vous comptez référencer ce fichier dans le contenu d’un message Anthropic, continuez à utiliser les en-têtes natifs Anthropic (x-api-key, anthropic-version et, si nécessaire, le beta header).

​
Exemple de réponse

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

​
Champs importants

​
id
string
Identifiant de fichier utilisé par les API liées.
​
purpose
string
Finalité attribuée au fichier. Les téléversements acceptent batch, user_data ou vision.
​
bytes
integer
Taille du fichier en octets.