Télécharger un fichier

AperçuCopy Anchor Link

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 chargeCopy Anchor Link

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.

RemarquesCopy Anchor Link

• 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.

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éponseCopy Anchor Link

Utilisez le panneau OpenAPI interactif ci-dessus pour le schéma exact.

Conseils opérationnelsCopy Anchor Link

• 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.

Entrées de fichiers imageCopy Anchor Link

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 limité au modèle d’édition d’image sélectionné et peut être réutilisé dans images[].file_id.

Mode Anthropic Files APICopy Anchor Link

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 limité au même espace de travail compatible Anthropic 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).

Expiration du fichierCopy Anchor Link

Pour les fichiers d'entrée batch, vous pouvez définir facultativement une fenêtre d'expiration avec expires_after[anchor]=created_at et expires_after[seconds]. La valeur en secondes doit être comprise entre 3600 et 2592000.

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

Champs importantsCopy Anchor Link