ホーム › バッチAPI
Grokガイド
Grok Batch API:割引・上限・作り方
Batch APIは、すぐの回答が要らない大量の処理を安く出す方法です。対象モデルは標準料金から20%引きで、多くは24時間以内に終わります(保証はなし)。
割引の対象
20%引きの対象は、grok-4.7・grok-4.6・grok-4.5・grok-4.3・grok-4.20-0309-reasoning・grok-4.20-0309-non-reasoning・grok-4.20-multi-agent-0309です。入力・出力・キャッシュ・推論の各トークンに適用されます。画像・動画の生成は標準料金で、一覧にないモデルは割引なしです。
使えるエンドポイント(JSONLのurl)
| 種類 | エンドポイント |
|---|---|
| テキスト | /v1/chat/completions、/v1/responses |
| 画像 | /v1/images/generations、/v1/images/edits |
| 動画 | /v1/videos/generations(/v1/videos)、/v1/videos/edits、/v1/videos/extensions |
バッチ対応のモデルだけが受け付けられ、そのほかは拒否されます。
作り方
POST https://api.x.ai/v1/batchesに名前を渡して作成し、batch_idを受け取る。POST /v1/batches/{batch_id}/requestsでリクエストを追加する。各リクエストに一意のbatch_request_idが必要(省略すると自動で付く)。- JSONLファイルをFiles APIで上げて、
input_file_idでバッチを作る方法もある。各行はcustom_id・method・url・body。 - 保留中のリクエストが0になるまでステータスを確認し、結果をページごとに取得する。
ファイルの上限は200MB・5万リクエストです。
向いている処理
大量の文書の分類、過去のデータの要約、評価用の一括実行など、待てる処理が向いています。画面の応答や会話には向きません。レート制限との関係はレート制限を参照してください。
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
24時間以内に必ず終わりますか?
公式は、完了は最善の努力で、保証はないと説明しています。
割引の割合はどこで確認しますか?
公式の価格ページの「Batch API Pricing」で確認します。
更新履歴
- 公式ドキュメントと照合して全面的に書き直しました。