ファイルとバッチ
Create Message Batch
非同期で実行されるMessagesリクエストのバッチを作成します。
概要
1回の呼び出しで最大100,000件のMessagesリクエストを送信します。バッチは非同期で実行されます。レスポンスは即座に返され、processing_statusはin_progressに設定されます。バッチがendedになるまでバッチを取得し、その後結果を取得してください。
注意事項
requests内の各アイテムにはcustom_idとparamsが必要です。paramsはメッセージを作成と同じフィールド(max_tokensを含む)を受け取ります。アイテムでspeed: "fast"を使用することはできません。custom_idは1〜64文字の英数字、アンダースコア、またはハイフンで構成され、バッチ内で一意である必要があります。- バッチ内のすべてのモデルは、バッチ処理に対応している必要があります。モデルが対応していない場合、またはバッチ内のすべてのモデルを処理できる単一のルートが存在しない場合、TokenLabはリクエスト全体を
400エラーで拒否します。 - TokenLabはバッチを受け付けた時点で推定コストを確保し、残高が不足している場合は
402を返します。バッチ終了後、TokenLabは成功したリクエストの使用量を精算します。バッチの価格は同期リクエストの価格と異なる場合があります。 - アイテムが
file_idコンテンツを参照する場合は、anthropic-beta: files-api-2025-04-14を送信してください。 - タイムアウトした作成リクエストを安全に再試行するには、
Idempotency-Keyを送信してください。詳細はIdempotency-Keyによる安全な再試行を参照してください。
リクエスト
curl -X POST "https://api.tokenlab.sh/v1/messages/batches" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Idempotency-Key: 6f1c2a9e-0b7d-4c1e-9a53-2d9f3a1b7c10" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"custom_id": "request-1",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude!"}]
}
},
{
"custom_id": "request-2",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Name three colors."}]
}
}
]
}'レスポンス
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "in_progress",
"request_counts": {
"processing": 2,
"succeeded": 0,
"errored": 0,
"canceled": 0,
"expired": 0
},
"ended_at": null,
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": null
}重要なフィールド
in_progress、canceling、またはended。processing、succeeded、errored、canceled、またはexpired状態のリクエスト数。expiredとして終了します。nullです。認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。
指定できる値
- "auto"
- "verified"
- "official"
作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(UUIDなど)を送信してください。同じキーとボディで再試行すると、元の作成リクエストの結果(通常は元のタスク)が返され、2つ目のタスクの作成、ディスパッチ、課金は行われません。すでに受け入れられたキーで異なるボディを指定すると、409で拒否されます。255文字を超えるキーは無視され、そのリクエストには冪等性保護が適用されません。詳細は冪等性キーを使用した安全な再試行を参照してください。
1 <= length <= 255リクエストボディ
application/json
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json