Claude Fable 5.2 バッチAPIチュートリアル:低コストで大規模ワークロードを処理する
Claude Fable 5.2をMessage Batches APIと組み合わせて、標準トークンレートの50%で非同期のドキュメント分析、コードレビュー、評価にご利用いただけます。

Message Batches APIは、即時の応答を必要としない作業に経済的なルートを提供します。Anthropicは現在、Claude Fable 5.2のバッチ入出力を標準料金の50%で請求しています:100万トークンあたり$4と$20(通常は$8と$40)。
バッチ処理は、より高速なインタラクティブモードではありません。バッチは最大24時間かかることがあり、結果はストリームではなくファイルとして届き、各リクエストは独立してマッチング、検証、再試行できるように設計する必要があります。
バッチ処理に適したワークロード
- 固定ルーブリックに対して数千のプロンプトを評価する
- 文書コレクションからのフィールドの分類または抽出
- 独立したコード変更のレビュー
- オフライン研究サマリーの作成
- コンテンツアーカイブのメタデータを生成中
- 過去のサポートケースの再処理
- モデル移行の比較を実行中
人が待機している場合、後続のリクエストが以前の応答に依存する場合、またはツールが急速に変化する外部システムと対話する必要がある場合は、バッチ処理を避けてください。
各リクエストを独立した単位として設計する
各リクエストには一意の custom_id が必要です。サービスは送信順とは異なる順序で結果を返す可能性があるため、配列の位置で照合しないでください。
from anthropic import Anthropic
client = Anthropic()
batch = client.messages.batches.create( requests=[ { "custom_id": "contract_0001", "params": { "model": "claude-fable-5-2", "max_tokens": 2048, "messages": [{ "role": "ユーザー", "content": "終了日を抽出し、関連条項を引用すること。" }], }, }, { "custom_id": "contract_0002", "params": { "model": "claude-fable-5-2", "max_tokens": 2048, "messages": [{ "role": "ユーザー", "content": "終了日を抽出し、関連条項を引用すること。" }], }, }, ] )
実際のワークフローでは、適切なドキュメントの内容やファイル参照を含め、`custom_id` をソース、バージョン、期待されるスキーマ、および権限にリンクするマニフェストを保持してください。
## 処理ライフサイクル
1. リクエストをローカルで検証します。
2. バッチを送信します。
3. バッチIDと入力マニフェストを保存します。
4. 適切な間隔でポーリングするか、サポートされているステータスワークフローを使用してください。
5. 処理終了後に結果をダウンロードしてください。
6. 各結果を `custom_id` で照合します。
7. 成功、エラー、期限切れ、キャンセル、拒否されたアイテムを分離します。
8. ダウンストリームへの書き込み前に出力を検証する。
9. 失敗ポリシーが許可するアイテムのみを再試行します。
5つのアイテムが失敗したからといって、バッチ全体を再送信しないでください。成功した作業とコストが2倍になります。
## リクエスト設計を変える制限
Anthropicの現在のAPIリファレンスでは、メッセージバッチ内で最大100,000件のリクエストが許可されており、一意の`custom_id`値は1~64文字までサポートされています。ファーストパーティのバッチAPIリクエストサイズ制限は256 MBです。
いくつかの同期オプションはサポートされていません:
- `stream: true`
- `speed` / 高速モード
- サーバーサイドの `fallbacks`
- 通常のバッチ処理における `max_tokens: 0`
現在のドキュメントに照らして検証してください。制限やサポートされるパラメータは変更される可能性があります。
## 拒否は技術的エラーとは別に処理する
拒否は一時的なインフラエラーのようなものではありません。同じアイテムを無期限に再試行すると、コストの無駄が生じ、安全境界を回避しようとする可能性があります。製品に応じて、より安全なヘルプを提供する、人間によるレビューに回す、または文書化されたフォールバックポリシーを使用してください。
`529`の過負荷、不正なリクエスト、拒否には異なる対応が必要です。高レベルのアイテム状態と詳細な結果の両方を保存してください。
## バッチ処理とプロンプトキャッシュを慎重に組み合わせる
長いルーブリックやポリシーマニュアルなど、繰り返し使用される安定したコンテキストは、サポートされている場合にキャッシュできます。バッチ処理では50%割引が適用され、キャッシュは独自の乗数を使用します。プレフィックスを安定させ、実際の使用量フィールドを使用して節約を確認してください。
並列バッチアイテムがすべて、まだ作成されていないキャッシュにヒットすると想定しないでください。ドキュメントに記載されたキャッシュ動作に従って、ワークフローをウォームアップまたは構造化してください。
## 品質管理パターン
抽出ジョブの場合:
- サポートされている場合は、構造化出力または厳密なスキーマを使用してください。
- `source_id` と証拠フィールドを含めてください。
- 必須フィールドと列挙型をローカルで検証します。
- 人間によるレビューのために受け入れられたサンプル出力。
- 低エビデンスのレコードを推測するのではなく、二次パスに回す。
評価のために:
- 可能な限りモデルの正体を隠蔽する。
- プロンプトとルーブリックのバージョンを保持する。
- 努力、ツール、最大トークンを記録します。
- バッチ結果を、その違いを明記せずにインタラクティブなプレミアムスピードルートと比較しないでください。
## よくある質問
### Claudeのバッチ処理にはどのくらい時間がかかりますか?
Anthropicによると、バッチ処理には最大24時間かかる可能性があります。実際の時間は変動するため、平均値に基づいてユーザー向けのレイテンシー保証を構築しないでください。
### Fable 5.2 の高速モードはバッチ処理で使用できますか?
いいえ。Fastモードは同期出力のレイテンシを最適化するもので、メッセージバッチではサポートされていません。
### バッチの方が常に安いのか?
トークンあたりの料金は低いものの、バリデーションの不備、重複した再試行、不要なFableの使用によって無駄が生じる可能性があります。品質基準を満たす場合は、単純なバルク作業をより安価なモデルにルーティングしてください。


















































































































