TokenLab

檔案與批次

擷取訊息批次

擷取訊息批次 (Message Batch) 的狀態與請求計數。

GET
/v1/messages/batches/{message_batch_id}

概覽

傳回貴組織所建立之訊息批次的狀態、請求計數與時間戳記。請輪詢此端點直到 processing_status 變為 ended,然後取得結果。

注意事項

  • processing_status 為 in_progress、canceling 或 ended。
  • 在批次結束前,results_url 為 null。
  • 若批次不存在或已被刪除,將傳回 404。若批次尚未準備好讀取,可能會傳回 409;請稍後重試。

範例

請求

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

回應範例

回應

200 OK
{
  "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