檔案與批次
擷取訊息批次
擷取訊息批次 (Message Batch) 的狀態與請求計數。
概覽
傳回貴組織所建立之訊息批次的狀態、請求計數與時間戳記。請輪詢此端點直到 processing_status 變為 ended,然後取得結果。
注意事項
processing_status為in_progress、canceling或ended。- 在批次結束前,
results_url為null。 - 若批次不存在或已被刪除,將傳回
404。若批次尚未準備好讀取,可能會傳回409;請稍後重試。
請求
curl -X GET "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01"回應
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "ended",
"request_counts": {
"processing": 0,
"succeeded": 2,
"errored": 0,
"canceled": 0,
"expired": 0
},
"ended_at": "2026-11-01T10:20:00Z",
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results"
}重要欄位
processing_statusstring
in_progress、canceling 或 ended。request_countsobject
處於
processing、succeeded、errored、canceled 或 expired 狀態的請求數量。ended_atstring|null
處理結束的時間,或為
null。cancel_initiated_atstring|null
取消請求被接受的時間,或為
null。results_urlstring|null
結果的 URL,或為
null。授權
BearerAuth AuthorizationBearer <token>
API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
路徑參數
message_batch_id*string
訊息批次識別碼
回應
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json