Fichiers & lots
Créer un lot de messages
Crée un lot de requêtes de messages qui s'exécutent de manière asynchrone.
Aperçu
Envoyez jusqu'à 100 000 requêtes de messages en un seul appel. Le lot s'exécute de manière asynchrone. La réponse est renvoyée immédiatement avec processing_status défini sur in_progress. Récupérez le lot jusqu'à ce qu'il soit ended, puis obtenez les résultats.
Remarques
- Chaque élément dans
requestspossède uncustom_idet desparams.paramsaccepte les mêmes champs que Créer un message, y comprismax_tokens. Les éléments ne peuvent pas utiliserspeed: "fast". custom_iddoit comporter de 1 à 64 lettres, chiffres, traits de soulignement ou tirets, et doit être unique au sein du lot.- Chaque modèle dans le lot doit être disponible pour les lots. TokenLab rejette l'intégralité de la requête avec une erreur
400si ce n'est pas le cas, ou si aucune route unique ne peut servir tous les modèles du lot. - TokenLab réserve le coût estimé lorsqu'il accepte le lot et renvoie une erreur
402si le solde ne peut pas le couvrir. Une fois le lot terminé, TokenLab règle l'utilisation des requêtes qui ont réussi. Les prix des lots peuvent différer des prix synchrones. - Si un élément fait référence au contenu d'un
file_id, envoyezanthropic-beta: files-api-2025-04-14. - Envoyez un
Idempotency-Keypour réessayer une requête de création ayant expiré en toute sécurité. Voir Réessayer en toute sécurité avec une clé d'idempotence.
Requête
curl -X POST "https://api.tokenlab.sh/v1/messages/batches" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Idempotency-Key: 6f1c2a9e-0b7d-4c1e-9a53-2d9f3a1b7c10" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"custom_id": "request-1",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude!"}]
}
},
{
"custom_id": "request-2",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Name three colors."}]
}
}
]
}'Réponse
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "in_progress",
"request_counts": {
"processing": 2,
"succeeded": 0,
"errored": 0,
"canceled": 0,
"expired": 0
},
"ended_at": null,
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": null
}Champs importants
in_progress, canceling ou ended.processing, succeeded, errored, canceled ou expired.expired.null tant que le lot n'est pas terminé.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
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Clé optionnelle qui permet de réessayer une requête de création en toute sécurité. Envoyez une nouvelle valeur unique, telle qu'un UUID, pour chaque tâche. Une tentative avec la même clé et le même corps renvoie le résultat de la requête de création initiale, généralement la tâche d'origine, et ne crée, ne distribue ni ne facture une seconde tâche. Un corps différent avec une clé déjà acceptée est rejeté avec 409. Une clé de plus de 255 caractères est ignorée, et la requête ne bénéficie alors d'aucune protection d'idempotence. Voir Réessayer en toute sécurité avec une clé d'idempotence.
1 <= length <= 255Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json