Fichiers & lots
Récupérer le fichier
Récupère les métadonnées d’un seul fichier téléversé.
Aperçu
Ce point de terminaison sert principalement les objets de fichier de l’API Batch compatible avec OpenAI de TokenLab.
Lorsque la requête active le mode de compatibilité Anthropic Files, la même route peut aussi renvoyer des métadonnées de fichier de style Anthropic pour l’espace de travail lié.
Sans en-têtes Anthropic, cette route peut renvoyer un objet de fichier de lot ou un objet de fichier image/référence TokenLab.
Remarques
- Les fichiers d'entrée de lot doivent utiliser
purpose=batch. - Utilisez
purpose=batch_outputpour vous concentrer sur les fichiers de sortie générés. completion_windowest actuellement24h.- L'ordre de sortie n'est pas garanti ; il faut toujours faire correspondre par
custom_id. - Le streaming n'est pas pris en charge à l'intérieur des éléments de lot.
Requête
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"Requête / Réponse
Utilisez le panneau OpenAPI interactif ci-dessus pour le schéma exact.
Conseils opérationnels
- Utilisez
custom_idpour la réconciliation idempotente en aval. - Attendez-vous à ce que
output_file_ideterror_file_idne soient disponibles qu'après que le travailleur finalise le lot.
Fichiers de référence d'image
Ce point de terminaison peut également renvoyer les métadonnées des fichiers de référence d'image créés par TokenLab. Le champ status est facultatif et peut être absent pour les familles de fichiers qui ne le fournissent pas.
Réponse
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Champs importants
batch, batch_output, 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
Paramètres de chemin
En-têtes
Inclure files-api-2025-04-14 pour utiliser le mode Anthropic Files API.
Réponse
application/json
application/json