Grok

HopBase の OpenAI 互換 API 経由で xAI の Grok チャット・推論・画像モデルを呼び出します。長コンテキストの料金、推論トークンの計上方法、サーバー側ツールの課金を含みます。

xAI の Grok モデルは HopBase の OpenAI 互換プロトコル経由で提供されます。https://api.hop-base.com/v1 と、GET /v1/models が返す正確なモデル ID を使用してください。エイリアスや短縮名は登録されていません。

Grok の動画モデル(grok-imagine-video-1.5)は別のプランに属し、非同期タスク API を使用します。詳しくはGrok Imagine の画像と動画を参照してください。

チャット・推論モデル

モデル ID	コンテキストウィンドウ
`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 のどちらも利用できるため、Codex CLI や任意の OpenAI SDK クライアントからこれらのモデルに到達できます。

マルチエージェントは Responses 専用です

grok-4.20-multi-agent-0309 は xAI の設計により Responses 専用です。chat/completions 経由で呼び出すと明確なエラーが返ります。これはモデル自体の制約であり、ゲートウェイによる制限ではないため、エラーメッセージは xAI 由来のものです。

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

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

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

レスポンス内の推論トークン

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

エンドポイント	出力フィールド	推論を含むか
`/v1/chat/completions`	`completion_tokens`	含まない — 推論分は `completion_tokens_details.reasoning_tokens` に別立てで報告されます
`/v1/responses`	`output_tokens`	含む

HopBase は xAI のレスポンスボディをそのまま転送するため、chat/completions では 1 回の応答で completion_tokens: 1 と reasoning_tokens: 158 が同時に報告されることがあります。実際の出力長を求めるには両者を足してください。/v1/responses ではすでに含まれています。

ストリーミングレスポンスから使用量を読み取る場合、このモデルは最終の usage チャンクで、常に 0 に固定されたミラーフィールド input_tokens と output_tokens を出すことがあります。その場合 HopBase は標準フィールドの値で補完します。

サーバー側ツール

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 の画像と動画を参照してください。

curl

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

プランの選択

チャットモデルと画像モデルは Grok Suite(Grok 総合)プランから、動画は Grok Video プランから提供されます。キーは 1 つのプランに紐づいているため、チャットモデルに到達できるキーが動画モデルに到達することはありません。実際に使用するキーで GET /v1/models を確認し、適用レートはログイン後のモデル広場でご確認ください。