TokenLab
Obtenir une clé API
DocumentationRéférence APIIntégrations

Fichiers & lots

Lister les fichiers

Lister les fichiers de traitement par lots (batch) et de référence d'image téléchargés.

GET
/v1/files

Lister les fichiers de traitement par lots et de référence d'image. Filtrez avec purpose=batch, purpose=batch_output, purpose=user_data ou purpose=vision.

Avec les en-têtes Anthropic Files, la même API liste les fichiers au format Anthropic dans l'espace de travail actuel.

Exemple

Requête

cURL
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

Filtres

  • Pour les fichiers de traitement par lots et de référence d'image, limit est compris entre 1 et 10000 (par défaut 10000), avec after pour la pagination. En mode Anthropic Files, limit est compris entre 1 et 1000 (par défaut 20) ; utilisez soit after_id, soit before_id, mais pas les deux.
  • purpose peut être batch, batch_output, user_data ou vision.
  • user_data et vision renvoient les fichiers de référence d'image créés par TokenLab lorsqu'ils sont disponibles.

Exemple de réponse

Réponse

200 OK
{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

Champs importants

objectstring
Toujours list.
dataarray
Fichiers.
has_moreboolean
D'autres résultats sont disponibles lorsque has_more est vrai.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de requête

limit?integer
Plage1 <= value <= 1000
par défaut20
after?string
after_id?string

Curseur Anthropic Files. Renvoie les fichiers après cet ID de fichier public. Nécessite l'en-tête Anthropic Files beta et ne peut pas être combiné avec before_id.

before_id?string

Curseur Anthropic Files. Renvoie les fichiers avant cet ID de fichier public. Nécessite l'en-tête Anthropic Files beta et ne peut pas être combiné avec after_id.

scope_id?string

Curseur de portée réservé Anthropic Files. TokenLab renvoie actuellement une erreur explicite non prise en charge plutôt que d'ignorer silencieusement cette valeur.

purpose?string

Filtre de but de fichier optionnel. batch et batch_output couvrent les fichiers de l'API Batch ; user_data et vision couvrent les liaisons de fichiers image/référence TokenLab. Le mode Anthropic Files API est sélectionné par les en-têtes Anthropic plutôt que par ce paramètre de requête.

Valeurs possibles

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

En-têtes

anthropic-beta?string

Inclure files-api-2025-04-14 pour utiliser le mode Anthropic Files API.

Réponse

application/json

application/json

Télécharger un fichier

Précédent

Récupérer un fichier

Suivant