ファイルとバッチ

Create Message Batch

非同期で実行されるMessagesリクエストのバッチを作成します。

POST
/v1/messages/batches

概要

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
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."}]
        }
      }
    ]
  }'

レスポンス例

レスポンス

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

重要なフィールド

idstring
Message batch ID。バッチの取得、キャンセル、削除、および結果の取得に使用します。
processing_statusstring
in_progress、canceling、またはended。
request_countsobject
processing、succeeded、errored、canceled、またはexpired状態のリクエスト数。
expires_atstring
バッチの有効期限。それまでに完了しなかったリクエストはexpiredとして終了します。
results_urlstring|null
結果のURL。バッチが終了するまではnullです。

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(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