Arquivos e lotes

Recuperar Resultados de Lote de Mensagens

Transmite os resultados de um Lote de Mensagens como JSONL.

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

Visão Geral

Transmita os resultados de um Lote de Mensagens como JSONL, uma linha por solicitação. Leia os resultados após o processing_status ser ended. Esta é a mesma URL que results_url no objeto de lote.

Notas

  • Cada linha é {"custom_id": "...", "result": {...}}. As linhas não possuem uma ordem fixa; faça a correspondência de cada uma pelo custom_id.
  • result.type é succeeded (com message, o mesmo corpo que uma resposta de Criar Mensagem), errored (com error), canceled ou expired.
  • Em message, model é o ID do modelo que você enviou na solicitação.
  • Um lote que não existe ou foi excluído retorna 404. Um lote que ainda não está pronto para ser lido pode retornar 409; tente novamente mais tarde.

Exemplo

Requisição

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"

Exemplo de resposta

Resposta

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
O custom_id que você definiu na solicitação.
result.typestring
succeeded, errored, canceled ou expired.
result.messageobject
A mensagem, quando result.type é succeeded.
result.errorobject
O erro, quando result.type é errored.

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

message_batch_id*string

Identificador do lote de mensagens

Resposta

application/x-ndjson

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json