Skip to main content
このページでは、/v1/chat/completions エンドポイントで Grok シリーズが実行できるすべての内容を扱います。すべての結論は、2026 年 7 月 13 日 (UTC+8) に APIYI ゲートウェイに対して実施した実地テストに基づいています。

Basic Chat and Streaming

6つのモデルはいずれも標準のOpenAI形式とストリーミングをサポートしています。stream_options: {"include_usage": true} は動作確認済みです(最終チャンクに完全な使用量が含まれます):
計測されたストリーミングの最初のtokenまでの時間: すべてのモデルで 1.5–2.3 秒。非ストリーミングの短いQ&Aは全体で 1.7–5.1 秒で完了します。

思考の連鎖(推論)

これは Grok シリーズで最も誤解されやすい課金の側面です — このセクションを最後までお読みください。

どのモデルが思考の連鎖を出力するか

推論に使われた tokens は出力課金の対象です。 ある短い Q&A の計測では、表示された回答は 30 tokens しかありませんでしたが、586 output tokens が課金されました(うち 556 は推論でした)。短い Q&A を高頻度で処理する場合、grok-4.20-0309-non-reasoning により大きく節約できます。

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"}})による強制ツール呼び出しも正常に動作することを確認済みです。
このセクションはクライアントサイドの関数呼び出しについて説明しています(ツールを実行するのはあなたのコードです)。xAIのサーバーに検索、コード実行、またはMCPへの接続を任せたい場合は、Responses APIを使用してください — Web & X SearchCode Execution & MCP を参照してください。

Vision 入力(画像理解)

Grok 4.x チャットモデルは、OpenAI Vision 形式で画像入力(jpg / png、画像ごとに最大20MiB)を受け付けます。grok-4.5 / grok-4.3 / grok-4.20-0309-non-reasoning で検証済みで、いずれも形状と色を正しく識別しました:
base64 data URL を優先してください。 外部 URL を使う場合、画像は xAI の上流サーバーによって直接取得されます — テストでは、Wikimedia など一部の画像ホストがサーバー側の取得を拒否し、image_download_error でリクエストが失敗しました。外部 URL を使う必要がある場合は、ホストがサーバー側アクセスを許可していること、および URL が画像ファイルを直接指していることを確認してください。

プロンプトキャッシュ(自動)

Grok のプレフィックスキャッシュは自動で、設定不要です。テストでは、同じプレフィックスの2回目以降のリクエストで 2688/2735 tokens がキャッシュヒットし、割引キャッシュ料金で課金されました。
最適化: 安定した内容(system prompt、few-shot examples)はメッセージの先頭に、変動する内容は末尾に配置して、プレフィックスのヒットを最大化してください。APIYI ゲートウェイは key-pool モードで動作するため、ヒット率については現実的な期待値を設定してください(100% は保証されません)。課金の詳細は キャッシュ課金 をご覧ください。

よくある質問

できません。内部推論は grok-4.5 / grok-4.3 / grok-build-0.1 に固有です。推論過程が不要で、高速かつ低コストな回答が欲しい場合は、代わりに grok-4.20-0309-non-reasoning を使用してください。
いいえ。マルチターン会話で履歴を再現する場合は、content のみ(tool-calling フィールドを除く)を返してください。reasoning_content は標準フィールドではありません。これをそのまま返すと input tokens を増やすだけです。
推論過程も出力バジェットを消費します。max_tokens が小さすぎると、推論がバジェット全体を使い切って表示される回答が途中で切れることがあります。推論モデルでは、2048 以上から始めてください。
はい、通常どおり受け付けられます。推論系モデルは従来型モデルよりサンプリングパラメータの影響を受けにくいため、調整の余地は限られます。

関連ドキュメント

Grok の概要

モデルラインナップ、価格、機能マトリクス

Web & X 検索

サーバーサイドのライブ検索ツールをハンズオンで使う