Grok 4.6 API

xAI の Grok 4.6 を OpenAI 互換のチャットとして呼び出すエンドポイントです。スクリーンショットと、それについての質問を同じユーザーターンに載せられます。

Grok 4.6 は xAI のモデルで、POST https://api.spicyapi.ai/v1/chat/completions にモデル名 xai/grok-4.6 で送ります。リクエストの構成は見慣れたものです。最大 256 ターンの messages 配列、出力上限、サンプリングのつまみ 2 つ、ツール一覧、応答形式、そして書き出す前にどこまで考えるかを決める reasoning_effort があります。コンテキストウィンドウは 500,000 トークン、1 回の返答は 450,000 トークンまで取れるので、予算の大きいほうをプロンプト側ではなく答え側に置けます。content が受け取るのは text パートと image_url パートで、このエンドポイントに file や PDF のパートはありません。モダリティはテキストと画像を入れてテキストが返る形です。

画像と、それについての一文を、ひとつのターンで

content は素の文字列でも、パートの配列でもかまいません。画像パートは url と、auto / low / high の detail ヒントを持ちます。キャプチャとそれについての問いが一緒に届くので、モデルはお客様の説明ではなくピクセルそのものを読みます。ラベルを付け間違えた軸、端で切れたスタックトレース、ある幅でだけ崩れるレイアウト。答えがそこにかかっているとき、その差はそのまま結果の差になります。画像の内容は 500,000 トークンのコンテキストウィンドウの外ではなく中で計上されるため、大きなキャプチャを何枚も送ると長い履歴と同じ予算を奪い合います。

予算のほとんどを答えに回せます

1 回の返答は 450,000 トークンまで伸びます。チャットモデルとしては珍しい形で、ウィンドウの大半を読むためではなく書くために使えます。max_tokens の既定は 4,096 のままなので、長い生成は自分から要求するものであって、うっかり入り込むものではありません。既定のまま打ち切られても警告は出ません。reasoning_effort は low / medium / high / xhigh から選べ、既定は high です。推論に使った分は出力トークンとして消費されるので、上限と請求額の両方に同時に効きます。

経路に当社のものは何も挟まっていません

お客様とこのモデルのあいだに、当社独自の分類器は置いていません。モデルが書かないと判断したものはモデル自身の振る舞いであって、ここで挟んだ層ではありません。送った内容が途中で走査・採点・書き換えされることもありません。送る素材の権利はお客様に帰属し、返ってきた応答の使い道についてもお客様が責任を負います。

説明するかわりにキャプチャを渡す

detail を high にしたスクリーンショットを、質問と同じユーザーメッセージに入れて送ります。モデルはピクセルから読み取ります。ラベルの間違った軸、消えた行、端で切れたフレーム。1 時間違いの 2 枚を同じターンに置けば、手で書き起こした要約についてではなく、どの数字が動いたのかを直接聞けます。

本一冊分を 1 回の呼び出しで書かせる

max_tokens を 450,000 近くまで上げれば、移行ガイドでも長い報告書でもテスト一式でも、継続の連鎖ではなくひとつの応答として返ってきます。つなぎ目のたびに筋が少しずつ失われることもありません。stream: true にすれば、書かれているそばからテキストが届きます。

ツールのループを読めるままにしておく

関数定義を最大 128 個まで宣言し、tool_choice と組み合わせ、結果は次のターンで tool ロールのメッセージとして返します。ループ全体で reasoning_effort を固定すれば、反復ごとに変わるのは会話だけになり、うまくいかなかったときにトレースを読む価値が出ます。

読み手が人ではなくコードのとき

response_format で JSON オブジェクトを指定し、temperature を 0 に落とせば、返ってくるのはパーサーがそのまま受け取れる構造です。画像パートと組み合わせれば、レシートや図表、フォームのキャプチャから、書き起こしの工程を挟まずに抽出できます。

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.6/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 リファレンスを参照してください。