ホーム › バッチ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

バッチ対応のモデルだけが受け付けられ、そのほかは拒否されます。

作り方

  1. POST https://api.x.ai/v1/batchesに名前を渡して作成し、batch_idを受け取る。
  2. POST /v1/batches/{batch_id}/requestsでリクエストを追加する。各リクエストに一意のbatch_request_idが必要(省略すると自動で付く)。
  3. JSONLファイルをFiles APIで上げて、input_file_idでバッチを作る方法もある。各行はcustom_id・method・url・body。
  4. 保留中のリクエストが0になるまでステータスを確認し、結果をページごとに取得する。

ファイルの上限は200MB・5万リクエストです。

向いている処理

大量の文書の分類、過去のデータの要約、評価用の一括実行など、待てる処理が向いています。画面の応答や会話には向きません。レート制限との関係はレート制限を参照してください。

確認した公式資料

上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。

あわせて読むページ

よくある質問

24時間以内に必ず終わりますか?

公式は、完了は最善の努力で、保証はないと説明しています。

割引の割合はどこで確認しますか?

公式の価格ページの「Batch API Pricing」で確認します。

更新履歴

  • 公式ドキュメントと照合して全面的に書き直しました。

編集:ちんあなご編集部(運営者情報)。誤りに気づいたらお問い合わせからお知らせください。