Grok

OpenAI 互換 API で Grok のチャット・推論・画像モデルを呼び出します。

項目	値
Base URL	`https://api.hop-base.com/v1`
チャット	`POST /v1/chat/completions`
Responses	`POST /v1/responses`
画像生成	`POST /v1/images/generations`

モデル ID は GET /v1/models が返す正確な値を使用してください。エイリアスや短縮名は登録されていません。

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [{
      "role": "user",
      "content": "Summarize this quarter'\''s risks in five bullets."
    }]
  }'

チャット・推論モデル

モデル ID	コンテキストウィンドウ
`grok-4.7`	500K
`grok-4.6`	500K
`grok-4.5`	500K
`grok-4.3`	1M
`grok-4.20-0309-reasoning`	2M
`grok-4.20-multi-agent-0309`	2M

POST /v1/chat/completions と POST /v1/responses は、どちらも任意の OpenAI SDK クライアントから利用できます。Codex CLI は Grok を直接使えません。Codex CLI は namespace 型のツールを送るため、モデルサービスが生成前に 422 で拒否します。/v1/responses では previous_response_id が削除され、store は false に固定されるため、毎ターン完全な input を送ってください。

422 Failed to deserialize the JSON body into the target type: tools[<n>].type: unknown variant `namespace`

チャットモデルと画像モデルは「Grok スイート」プランから、動画は「Grok ビデオ」プランから提供されます。動画モデルに届くのは、Grok ビデオも含むキーだけです。1 つのキーに両方のプランを含めることもできます。実際に使うキーで GET /v1/models を確認してください。

マルチエージェントは Chat Completions でも使えます：

xAI は grok-4.20-multi-agent-0309 を Responses でのみ提供しています。HopBase が chat/completions のリクエストを Responses に変換し、ストリーミング・非ストリーミングとも標準の Chat Completions 形式で返します。このモデルはクライアント側の関数ツール（tools）にまだ対応しておらず、どちらのエンドポイントでも xAI から 400 が返ります。

リクエストパラメータ

両エンドポイント共通です。ゲートウェイが拒否するのは Chat Completions の空の messages だけで、下記のパラメータに上限は設けていません。「公式」と記した制限は xAI の推論モデルガイドと API リファレンスによります。

パラメータ	必須	型と制限	デフォルト	説明
`model`	必須	上表の 6 つの ID のいずれか	—	完全一致。エイリアスなし
`messages` / `input`	必須	Chat は空でない `messages`、Responses は `input`	—	空の `messages` はゲートウェイが 400
`max_tokens` / `max_output_tokens`	任意	整数。ゲートウェイ上限なし、コンテキストウィンドウが上限	Responses の公式既定 128,000	公式には推論トークンを含みます
`temperature`	任意	数値 0–2(公式)	サービス既定	値が大きいほど出力が多様
`top_p`	任意	数値 0–1(公式)	サービス既定	`temperature` とどちらか一方の調整を推奨
`reasoning_effort`	任意	値は下記	`high`	推論はオフにできません
`tools`	任意	関数ツールとサーバー側ツール	—	サーバー側ツールは呼び出しごとに課金
`stream_options.include_usage`	任意	真偽値	`false`	Chat のストリーミングで `usage` を受け取るには `true`

reasoning_effort は公式にはこの 3 モデルのみで使えます。

grok-4.7:low / medium / high / xhigh。
grok-4.6:low / medium / high / xhigh。
grok-4.5:low / medium / high。
grok-4.20-multi-agent-0309 は reasoning.effort（Chat Completions では reasoning_effort）を使い、協調するエージェント数を決めます。

presence_penalty、frequency_penalty、stop は公式に非対応で、推論モデルはエラーを返します。grok-4.20 以降では logprobs、top_logprobs も非対応でトークンの対数確率は返されないため、指定しないでください。

全フィールドは API リファレンス · Chat Completions で Grok モデルファミリーを選んで確認できます。

課金と使用量

長コンテキストのリクエスト

プロンプトが 200,000 トークンを超えるリクエストは、長コンテキストのリクエストとして扱われます。

しきい値は、キャッシュされていない入力とキャッシュされた入力の合計でカウントされます。出力トークンはカウントされません。
ちょうど 200,000 トークンのリクエストはしきい値を超えません。超えるにはさらに 1 トークン必要です。
該当するリクエストは、コンソールの使用状況ページで long_context のフラグが付き、区別できます。

推論トークン

Grok は推論系のモデルファミリーであり、2 つのエンドポイントでは推論トークンの報告方法が異なります。usage をプログラムで読み取る際にはこの点に注意してください。

エンドポイント	出力フィールド	推論を含むか
`/v1/chat/completions`	`completion_tokens`	含まない
`/v1/responses`	`output_tokens`	含む

Chat Completions では推論分が completion_tokens_details.reasoning_tokens に別立てで報告されます。HopBase は xAI のレスポンスボディをそのまま転送するため、1 回の応答で completion_tokens: 1 と reasoning_tokens: 158 が同時に報告されることがあります。

実際の出力長を求めるには両者を足してください。/v1/responses ではすでに含まれているため、重ねて足さないでください。

サーバー側ツール

Grok はリクエスト中に組み込みのサーバー側ツールを呼び出せます。Web 検索、X 検索、コードインタープリタ、ドキュメント検索、ファイル検索です。MCP 呼び出しはお客様自身のリモートサービスに到達します。

1 回のリクエストで何回ツールを呼び出したかは、コンソールの使用状況ページにツールの種類別に表示されます。適用レートはログイン後のモデル広場でご確認ください。

画像モデル

Grok の画像モデル grok-imagine-image、grok-imagine-image-2.0、grok-imagine-image-quality は標準の OpenAI Images API を使用し、同期呼び出しのみに対応します。テキストから画像生成は POST /v1/images/generations、画像から画像生成は POST /v1/images/edits です。

画像の縦横比は aspect_ratio、画素数のティアは resolution で指定し、size はありません。完全なパラメータ、実測の出力サイズ、課金対象についてはGrok Imagine の画像と動画を参照してください。

Grok の動画モデル(grok-imagine-video-1.5)は「Grok ビデオ」プランに属し、非同期タスク API を使用します。同じページで説明しています。