Archivos y lotes

Recuperar resultados de un lote de mensajes

Transmite los resultados de un lote de mensajes (Message Batch) como JSONL.

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

Descripción general

Transmita los resultados de un lote de mensajes como JSONL, una línea por solicitud. Lea los resultados después de que processing_status sea ended. Esta es la misma URL que results_url en el objeto del lote.

Notas

  • Cada línea tiene el formato {"custom_id": "...", "result": {...}}. Las líneas no tienen un orden fijo; haga coincidir cada una mediante custom_id.
  • result.type puede ser succeeded (con message, el mismo cuerpo que una respuesta de Create Message), errored (con error), canceled o expired.
  • En message, model es el ID del modelo que envió en la solicitud.
  • Un lote que no existe o que fue eliminado devuelve 404. Un lote que aún no está listo para ser leído puede devolver 409; inténtelo de nuevo más tarde.

Ejemplo

Solicitud

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"

Ejemplo de respuesta

Respuesta

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"}}

Campos importantes

custom_idstring
El custom_id que estableció en la solicitud.
result.typestring
succeeded, errored, canceled o expired.
result.messageobject
El mensaje, cuando result.type es succeeded.
result.errorobject
El error, cuando result.type es errored.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

message_batch_id*string

Identificador del lote de mensajes.

Respuesta

application/x-ndjson

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json