Télécharger un fichier

Objectifs des fichiersCopy Anchor Link

• Fichiers de traitement par lots (batch) : utilisez purpose=batch pour /v1/batches.
• Fichiers d'image/référence : utilisez purpose=user_data ou purpose=vision pour les requêtes d'image basées sur des fichiers.
• Fichiers Anthropic : ajoutez l'en-tête anthropic-beta: files-api-2025-04-14.

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"

Entrées de fichiers imageCopy Anchor Link

Cette même route /v1/files permet de télécharger des fichiers de référence d'image pour /v1/images/edits.

• Utilisez purpose=user_data ou purpose=vision.
• Incluez éventuellement model pour sélectionner le modèle d'édition d'image ; la valeur par défaut est gpt-image-2.
• Le file_id renvoyé est lié à la configuration d'édition d'image sélectionnée et peut être réutilisé dans images[].file_id.

Mode API Anthropic FilesCopy Anchor Link

• Ajoutez anthropic-beta: files-api-2025-04-14 pour utiliser les fichiers Anthropic.
• En mode Anthropic, téléchargez directement le fichier original et n'envoyez pas purpose=batch.
• Le file_id renvoyé est disponible uniquement dans l'Espace de travail (Workspace) actuel et peut être réutilisé dans les requêtes /v1/messages.
• Si vous prévoyez de référencer le fichier téléchargé à partir du contenu d'un message Anthropic, continuez à utiliser les en-têtes natifs d'Anthropic (x-api-key, anthropic-version et l'en-tête beta lorsque requis).

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

Champs importantsCopy Anchor Link