Dateien & Batch-Jobs

Ergebnisse eines Message Batch abrufen

Streamt die Ergebnisse eines Message Batch als JSONL.

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

Überblick

Streamen Sie die Ergebnisse eines Message Batch als JSONL, eine Zeile pro Anfrage. Lesen Sie die Ergebnisse, nachdem processing_status auf ended steht. Dies ist dieselbe URL wie results_url im Batch-Objekt.

Hinweise

  • Jede Zeile hat das Format {"custom_id": "...", "result": {...}}. Die Zeilen haben keine feste Reihenfolge; ordnen Sie jede Zeile über die custom_id zu.
  • result.type ist succeeded (mit message, dem gleichen Body wie bei einer Nachricht erstellen Antwort), errored (mit error), canceled oder expired.
  • In message ist model die Modell-ID, die Sie in der Anfrage gesendet haben.
  • Ein Batch, der nicht existiert oder gelöscht wurde, gibt 404 zurück. Ein Batch, der noch nicht zum Lesen bereit ist, kann 409 zurückgeben; versuchen Sie es später erneut.

Beispiel

Anfrage

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"

Antwortbeispiel

Antwort

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

Wichtige Felder

custom_idstring
Die custom_id, die Sie in der Anfrage festgelegt haben.
result.typestring
succeeded, errored, canceled oder expired.
result.messageobject
Die Nachricht, wenn result.type den Wert succeeded hat.
result.errorobject
Der Fehler, wenn result.type den Wert errored hat.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

message_batch_id*string

Bezeichner des Nachrichten-Batch

Antwort

application/x-ndjson

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json