Fichiers & lots
Télécharger un fichier
Téléchargez un fichier de traitement par lots (batch), une référence d'image ou un fichier au format Anthropic.
Objectifs des fichiers
- Fichiers de traitement par lots (batch) : utilisez
purpose=batchpour/v1/batches. - Fichiers image/référence : utilisez
purpose=user_dataoupurpose=visionpour les requêtes d'image basées sur des fichiers. - Fichiers Anthropic : ajoutez l'en-tête
anthropic-beta: files-api-2025-04-14.
Limites
| Objectif | Taille maximale |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Fichiers Anthropic | 500 MB |
Un fichier plus volumineux renvoie 413 request_too_large. Un purpose autre que batch, user_data ou vision renvoie 400 unsupported_purpose. Une requête sans file renvoie 400.
Un fichier batch expire 24 heures après son téléchargement. Pour modifier cela, envoyez les champs de formulaire expires_after[anchor]=created_at et expires_after[seconds] avec une valeur comprise entre 3600 et 2592000 (30 jours). Le champ expires_at de la réponse indique l'heure d'expiration.
Requête
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 image
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_dataoupurpose=vision. - Incluez éventuellement
modelpour sélectionner le modèle de modification d'image ; la valeur par défaut estgpt-image-2. - Le
file_idrenvoyé est lié à la configuration de modification d'image sélectionnée et peut être réutilisé dansimages[].file_id.
Mode API Anthropic Files
- Ajoutez
anthropic-beta: files-api-2025-04-14pour utiliser Anthropic Files. - En mode Anthropic, téléchargez le fichier original directement et n'envoyez pas
purpose=batch. - Le
file_idrenvoyé 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-versionet l'en-tête beta lorsque requis).
Réponse
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Champs importants
batch, user_data ou vision.Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
Inclure files-api-2025-04-14 pour utiliser le mode Anthropic Files API.
Corps de la requête
multipart/form-data
Réponse
application/json
application/json
application/json
application/json