TokenLab

Fichiers & lots

Récupérer les résultats d'un lot de messages

Diffuse les résultats d'un lot de messages (Message Batch) au format JSONL.

GET
/v1/messages/batches/{message_batch_id}/results

Aperçu

Diffusez les résultats d'un lot de messages sous forme de JSONL, à raison d'une ligne par requête. Lisez les résultats une fois que processing_status est défini sur ended. Il s'agit de la même URL que results_url dans l'objet du lot.

Remarques

  • Chaque ligne est au format {"custom_id": "...", "result": {...}}. Les lignes ne sont pas dans un ordre fixe ; faites correspondre chacune d'elles via custom_id.
  • result.type peut être succeeded (avec message, le même corps qu'une réponse Créer un message), errored (avec error), canceled ou expired.
  • Dans message, model correspond à l'ID du modèle que vous avez envoyé dans la requête.
  • Un lot qui n'existe pas ou qui a été supprimé renvoie une erreur 404. Un lot qui n'est pas encore prêt à être lu peut renvoyer une erreur 409 ; réessayez plus tard.

Exemple

Requête

cURL
curl -X GET "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01"

Exemple de réponse

Réponse

200 OK (JSONL)
{"custom_id":"request-1","result":{"type":"succeeded","message":{"id":"msg_abc123","type":"message","role":"assistant","content":[{"type":"text","text":"Hello! How can I help you today?"}],"model":"claude-sonnet-5","stop_reason":"end_turn","stop_sequence":null,"usage":{"input_tokens":10,"output_tokens":9}}}}
{"custom_id":"request-2","result":{"type":"errored","error":{"type":"error","error":{"type":"invalid_request_error","message":"messages: at least one message is required"}}}}
{"custom_id":"request-3","result":{"type":"canceled"}}
{"custom_id":"request-4","result":{"type":"expired"}}

Champs importants

custom_idstring
Le custom_id que vous avez défini dans la requête.
result.typestring
succeeded, errored, canceled ou expired.
result.messageobject
Le message, lorsque result.type est succeeded.
result.errorobject
L'erreur, lorsque result.type est errored.

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 chemin

message_batch_id*string

Identifiant du lot de messages

Réponse

application/x-ndjson

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json