/v1/chat/completions エンドポイントで Grok シリーズが実行できるすべての内容を扱います。すべての結論は、2026 年 7 月 13 日 (UTC+8) に APIYI ゲートウェイに対して実施した実地テストに基づいています。
Basic Chat and Streaming
6つのモデルはいずれも標準のOpenAI形式とストリーミングをサポートしています。stream_options: {"include_usage": true} は動作確認済みです(最終チャンクに完全な使用量が含まれます):
思考の連鎖(推論)
これは Grok シリーズで最も誤解されやすい課金の側面です — このセクションを最後までお読みください。どのモデルが思考の連鎖を出力するか
Chain-of-Thought と推論使用量の読み方
reasoning_effort パラメータ
reasoning_effort(例: "low" / "high")は grok-4.5 でのみ受け付けられます; grok-4.20-0309-reasoning は 400 Model ... does not support parameter reasoningEffort で明示的に拒否します。クロスモデルのコードにこのパラメータをハードコードしないでください。
構造化出力
OpenAI準拠のresponse_format: json_schema(strict mode)に対応しています。grok-4.5 / grok-4.3 / grok-build-0.1 / grok-4.20-0309-reasoning とマルチエージェントモデルで動作確認済みで、すべてスキーマに厳密に準拠した JSON を返します:
関数呼び出し
OpenAI標準のtools / tool_choice フィールドと、完全な2ラウンドのツール呼び出しフローに対応しています(grok-4.5 / grok-4.3 / grok-build-0.1で検証済み):
tool_choice({"type": "function", "function": {"name": "get_weather"}})による強制ツール呼び出しも正常に動作することを確認済みです。
Vision 入力(画像理解)
Grok 4.x チャットモデルは、OpenAI Vision 形式で画像入力(jpg / png、画像ごとに最大20MiB)を受け付けます。grok-4.5 / grok-4.3 / grok-4.20-0309-non-reasoning で検証済みで、いずれも形状と色を正しく識別しました:
プロンプトキャッシュ(自動)
Grok のプレフィックスキャッシュは自動で、設定不要です。テストでは、同じプレフィックスの2回目以降のリクエストで 2688/2735 tokens がキャッシュヒットし、割引キャッシュ料金で課金されました。よくある質問
grok-4.5 の推論過程をオフにするにはどうすればよいですか?
grok-4.5 の推論過程をオフにするにはどうすればよいですか?
できません。内部推論は
grok-4.5 / grok-4.3 / grok-build-0.1 に固有です。推論過程が不要で、高速かつ低コストな回答が欲しい場合は、代わりに grok-4.20-0309-non-reasoning を使用してください。reasoning_content を次のターンのコンテキストに戻すべきですか?
reasoning_content を次のターンのコンテキストに戻すべきですか?
いいえ。マルチターン会話で履歴を再現する場合は、
content のみ(tool-calling フィールドを除く)を返してください。reasoning_content は標準フィールドではありません。これをそのまま返すと input tokens を増やすだけです。max_tokens はどのように設定すればよいですか?
max_tokens はどのように設定すればよいですか?
推論過程も出力バジェットを消費します。
max_tokens が小さすぎると、推論がバジェット全体を使い切って表示される回答が途中で切れることがあります。推論モデルでは、2048 以上から始めてください。temperature / top_p は機能しますか?
temperature / top_p は機能しますか?
はい、通常どおり受け付けられます。推論系モデルは従来型モデルよりサンプリングパラメータの影響を受けにくいため、調整の余地は限られます。
関連ドキュメント
Grok の概要
モデルラインナップ、価格、機能マトリクス
Web & X 検索
サーバーサイドのライブ検索ツールをハンズオンで使う