Grok 4.5 API

xAI の Grok 系列でコーディングを担う Grok 4.5 の、OpenAI 互換チャットです。1 つのターンに text と image_url のパートを載せられ、推論強度は xhigh まで上げられ、1 回の返答は 450,000 トークンに達します。

xAI は Grok 4.5 をエージェント的なソフトウェア開発、エンジニアリング、ワークフロー処理のために公開し、科学・工学・数学のデータを追加して学習させました。別名 grok-4.5-latest と grok-build-latest でも提供されています。ここでは /v1/chat/completions のエンドポイント 1 本として公開しており、最大 256 メッセージ・合計 500,000 トークンを読み、1 回の返答で 450,000 トークンまで返します。入力・キャッシュ入力・出力はそれぞれ別に計測されます。長い前置きを繰り返すエージェントのループが実際に支払っているのは、この区分です。

送り直す前置きには専用のメーターがあります

エージェントのループは毎ステップで同じ system プロンプト、同じツール定義、同じファイル一覧を送り、新しいのは会話の末尾だけです。キャッシュから返された入力は usage に別立てで数えられ、より安い独自の単価で計測されます。有効化の操作は要りません。ステップ間で先頭のメッセージを変えずに保つこと、それがこの技法のすべてです。どれだけがキャッシュに乗ったかは、推測ではなく返答が教えてくれます。

入力はテキストと画像、出力はテキスト

content は素の文字列でもパートの配列でもよく、このモデルは 2 種類のパートを宣言しています。{"type": "text", "text": "..."} と {"type": "image_url", "image_url": {"url": "...", "detail": "auto|low|high"}} です。スクリーンショットとその問いは同じターンで届き、画像の内容は 500,000 トークンのコンテキストウィンドウの外ではなく中で数えられます。このエンドポイントに file や PDF のパートはないので、仕様書もログも差分も貼り付けたテキストとして渡してください。推論強度は low / medium / high / xhigh で既定は high です。推論強度は出力トークンとして消費されるため、請求だけでなく返答の上限にも算入されます。

ループ全体をコンテキストに収めたまま回す

コーディングエージェントは毎ステップで指示、ツール定義、ファイル一覧を送り直し、そのたびに数百トークンだけを足します。そのすべてが 500,000 トークンのコンテキストウィンドウに収まり、繰り返し部分はキャッシュ入力として計測されます。長コンテキスト料金に切り替わるのは入力とキャッシュ入力の合計が 200,000 トークンに達したときだけで、送信前の見積もりが支払う前にそれを知らせます。

モジュールとテストと失敗を 1 ターンにまとめてリファクタリング

モジュール本体、テストファイル、失敗した出力をまとめて貼り、パッチとその根拠を求めてください。書き始める前に考え抜く必要がある変更では reasoning_effort を xhigh に上げます。最初の 1 行が出るまでに出力トークンを多く使いますが、行ごとにレビューする変更なら、それが割に合う選択です。

スクリーンショットとスタックトレースを一緒に読ませる

失敗しているダッシュボードを detail high の image_url パートとして添え、同じメッセージにスタックトレースをテキストで貼り、可能性の高い順に原因を挙げさせます。絵とログが 1 つのターンで届くので、モデルはお客様の説明ではなくパネルそのものを読みます。

移行計画を 1 回の応答で受け取る

450,000 の出力トークンがあれば、移行計画の全文、書き直したモジュール、翻訳したマニュアルが章ごとのループではなく 1 回の返答に収まります。max_tokens は明示的に上げてください。既定の 4,096 はエラーを出さずに長い生成を打ち切ります。途中で切れた返答は、完成した答えと最も見分けにくい失敗です。

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-4.5/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。