> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok モデルシリーズガイド

> APIYI 上の xAI Grok 4.x シリーズ（grok-4.5 / grok-4.3 / grok-4.20 / grok-build-0.1）：OpenAI 互換 + Responses API のデュアルエンドポイントに対応し、web search / X search / code execution / MCP サーバーサイド tools が動作確認済みです。掲載価格は xAI 公式と一致します。

Grok は xAI の主力モデルファミリーです。現行世代（Grok 4.x）は 5 つの製品ライン — フラッグシップの汎用、ロングコンテキスト標準、reasoning/非 reasoning バリアント、コード特化、マルチエージェント協調 — にまたがっており、すべて APIYI で利用できます。**xAI の公式 API 自体が OpenAI 互換**（Chat Completions + Responses API）で、別個の独自プロトコルはありません。そのため、OpenAI SDK を使って APIYI 経由で Grok を呼び出すと、公式のサーバーサイド tools（ウェブ検索、X search、コード実行、Remote MCP）を含む完全な機能セットを利用できます。

このドキュメントグループは、2026年7月13日 (UTC+8) に APIYI ゲートウェイに対して行った全面的な実地テスト — 56 件のリクエスト/レスポンスログ — に基づいているため、ここで述べるすべての機能範囲は検証済みです。

<Note>
  **🚀 Highlights**: grok-4.5 は xAI の最新フラッグシップで、2026年7月8日にリリースされました（知識カットオフは 2026年2月）。コーディングとエージェント系タスク向けに構築されています。grok-4.3 と grok-4.20 シリーズは **1M-token のコンテキストウィンドウ** を提供します。Responses API の tools **web\_search / x\_search / code\_interpreter / MCP は APIYI 上で動作確認済み** で、X search は Grok 固有の機能です。ネイティブな responses 対応により、Grok は [OpenAI Codex にそのまま接続できます](/ja/scenarios/programming/codex-cli)。
</Note>

## モデルラインナップ

<CardGroup cols={3}>
  <Card title="grok-4.5" icon="trophy">
    **フラッグシップ · コード＆汎用**

    xAIで最も高性能なモデルで、500Kのコンテキストを備え、コーディング、エージェント的なタスク、ナレッジワーク向けに設計されています。
  </Card>

  <Card title="grok-4.3" icon="scale">
    **標準の主力**

    フラッグシップ価格の約60%で1Mのコンテキストを利用でき、日常的なチャットと中程度の推論に最適なバランス型です。
  </Card>

  <Card title="grok-4.20 Variants" icon="split">
    **推論 / 非推論**

    `-reasoning` と `-non-reasoning` は同じ価格と1Mのコンテキストを共有しています。思考の連鎖を使いたいかどうかで選んでください。
  </Card>

  <Card title="grok-build-0.1" icon="code">
    **コード重視**

    256Kのコンテキストとシリーズ最安価格を備え、高頻度のコード補完や軽いコーディングタスクに最適です。
  </Card>

  <Card title="grok-4.20-multi-agent-beta-0309" icon="users">
    **マルチエージェント協働**

    複数のエージェントが複雑なリサーチタスクを並列で処理します。特別な課金プロファイルです。詳細は [マルチエージェントモデル](/ja/api-capabilities/grok/multi-agent) をご覧ください。
  </Card>

  <Card title="その他の機能ページ" icon="book-open">
    チャット/推論/ビジョン: [チャット＆推論](/ja/api-capabilities/grok/chat); ライブ検索: [Web & X 検索](/ja/api-capabilities/grok/web-search).
  </Card>
</CardGroup>

## 料金

掲載価格は xAI の公式料金と一致します（2026-07-13 に APIYI の料金 API と項目ごとに照合済み）。APIYI の割引は [チャージプロモーション](/ja/faq/recharge-promotions) によるものです。

| モデル ID                            | コンテキスト | 入力                 | 出力                 | 位置づけ                       |
| --------------------------------- | ------ | ------------------ | ------------------ | -------------------------- |
| `grok-4.5`                        | 500K   | \$2.00 / 1M tokens | \$6.00 / 1M tokens | フラッグシップ: コード / エージェント / 汎用 |
| `grok-4.3`                        | 1M     | \$1.25 / 1M tokens | \$2.50 / 1M tokens | 標準の主力モデル                   |
| `grok-4.20-0309-reasoning`        | 1M     | \$1.25 / 1M tokens | \$2.50 / 1M tokens | 推論版                        |
| `grok-4.20-0309-non-reasoning`    | 1M     | \$1.25 / 1M tokens | \$2.50 / 1M tokens | 非推論（高速・低コスト）               |
| `grok-4.20-multi-agent-beta-0309` | 1M     | \$1.25 / 1M tokens | \$2.50 / 1M tokens | マルチエージェント（課金増幅あり!）         |
| `grok-build-0.1`                  | 256K   | \$1.00 / 1M tokens | \$2.00 / 1M tokens | コード特化                      |

<Info>
  * エイリアス `grok-code-fast` / `grok-code-fast-1` も呼び出し可能です（接続確認済み）。料金は [モデル情報ページ](/ja/api-capabilities/model-info) をご覧ください。
  * キャッシュされた input tokens は割引レートで課金されます。Grok のプレフィックスキャッシュは **自動 — 設定不要です**。詳細は [キャッシュ課金](/ja/faq/cache-billing) をご覧ください。
  * 掲載価格は xAI 公式料金と一致します。実質コストを下げるには、[チャージプロモーション](/ja/faq/recharge-promotions) を併用してください。
</Info>

## 検証済み機能マトリックス

2026-07-13 (UTC+8) に APIYI ゲートウェイに対してテスト済みです（✅ 動作確認済み；— は未対象で、同一アーキテクチャでは同一動作が想定されます）:

| 機能                                   |  grok-4.5  |  grok-4.3  | 4.20-reasoning | 4.20-non-reasoning | grok-build-0.1 | multi-agent |
| ------------------------------------ | :--------: | :--------: | :------------: | :----------------: | :------------: | :---------: |
| 基本チャット                               |      ✅     |      ✅     |        ✅       |          ✅         |        ✅       |      ✅      |
| ストリーミング（使用量付き）                       |      ✅     |      ✅     |        ✅       |          ✅         |        ✅       |      ✅      |
| Chain-of-thought `reasoning_content` | ✅ デフォルトで有効 | ✅ デフォルトで有効 |        ✅       |       ❌ 設計上オフ      |   ✅ デフォルトで有効   |     内部のみ    |
| `reasoning_effort` パラメータ             |      ✅     |      —     |    ❌ 明示的に拒否    |          —         |        —       |      —      |
| 構造化出力 (json\_schema)                 |      ✅     |      ✅     |        ✅       |          —         |        ✅       |      ✅      |
| 関数呼び出し / ツール使用                       |      ✅     |      ✅     |        —       |          —         |        ✅       |      —      |
| ビジョン入力（画像理解）                         |      ✅     |      ✅     |        —       |          ✅         |        —       |      —      |
| プロンプトキャッシュ（自動）                       |      ✅     |      ✅     |        ✅       |          ✅         |        ✅       |      ✅      |
| Responses API + サーバーサイドツール           |      ✅     |      —     |        —       |          —         |        —       |      —      |

## エンドポイント

| Endpoint               | Method | 用途                                                          |
| ---------------------- | ------ | ----------------------------------------------------------- |
| `/v1/chat/completions` | `POST` | チャット / 推論 / 関数呼び出し / 構造化出力 / ビジョン（すべてのモデルで共通。`model`で選択）    |
| `/v1/responses`        | `POST` | Responses API: Web検索、X検索、コード実行、Remote MCP およびその他のサーバーサイドツール |

### Codex で直接使う

Grok は `/v1/responses` をネイティブにサポートしているため、ネイティブ responses プロトコルで **OpenAI Codex**（デスクトップアプリ / IDE 拡張 / CLI）を実行できる数少ない非 OpenAI モデルの1つです。`model = "grok-4.5"` と `wire_api = "responses"` を `config.toml` で設定すれば5分で接続でき、Codex のエージェント機能（ツール呼び出し、reasoning items など）もすべてネイティブプロトコル上で動作します。これに対して、APIYI 上の Claude / Gemini は OpenAI 互換のチャットモード（`wire_api = "chat"` フォールバック）でしか動作せず、Codex / エージェントのシナリオではプロトコルの非互換が発生します。詳しいセットアップ手順: [Codex 統合ガイド](/ja/scenarios/programming/codex-cli)。

<Warning>
  **APIYI では以下はサポートされていません**（検証済み — これらの落とし穴を避けてください）:

  * **レガシー Completions (`/v1/completions`)**: 上流側で拒否されます — Grok 4.x 系列全体は reasoning アーキテクチャであり、公式レベルでは生のテキスト補完をサポートしていません
  * **レガシー ライブ検索パラメータ `search_parameters`**: xAI により削除されました（410 を確認済み）。すべてのライブ検索は Responses API の tools 経由になります — [Web & X 検索](/ja/api-capabilities/grok/web-search) を参照
  * **Batch API / Files**: ゲートウェイ経由でルーティングされないため、キープールモードには適用されません
  * **Deferred Completions (`deferred: true`)**: パラメータは**黙って無視されます** — リクエストは同期的に実行され、通常どおり課金されます。これに依存しないでください
  * **Collections Search (RAG / file\_search)**: xAI コンソールで事前構築済みの collections が必要です。キープールモードには適用されません
  * **Context Compaction (`/v1/responses/compact`)**, **Priority Processing (`service_tier: "priority"` — テストではデフォルトにフォールバックします)**, **WebSocket モード**, **mTLS 認証**: いずれもサポートされていません
</Warning>

## クイックスタート

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.apiyi.com/v1/chat/completions" \
    -H "Authorization: Bearer sk-your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "grok-4.5",
      "messages": [
        {"role": "user", "content": "Introduce yourself in one sentence"}
      ]
    }'
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="sk-your-api-key",
      base_url="https://api.apiyi.com/v1"
  )

  resp = client.chat.completions.create(
      model="grok-4.5",
      messages=[{"role": "user", "content": "Introduce yourself in one sentence"}]
  )
  print(resp.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from 'openai';

  const client = new OpenAI({
    apiKey: 'sk-your-api-key',
    baseURL: 'https://api.apiyi.com/v1',
  });

  const resp = await client.chat.completions.create({
    model: 'grok-4.5',
    messages: [{ role: 'user', content: 'Introduce yourself in one sentence' }],
  });
  console.log(resp.choices[0].message.content);
  ```
</CodeGroup>

<Tip>
  **どのモデルを選ぶか**: デフォルトは `grok-4.3`（1M コンテキスト、バランスの取れた価格）にし、コーディングエージェントや複雑なタスクには `grok-4.5` にアップグレードしてください。高速で低コストな応答（chain-of-thought なし、最安の出力）には `grok-4.20-0309-non-reasoning` を使い、高頻度のコード補完には `grok-build-0.1` を使ってください。マルチエージェントモデルは、複雑なリサーチタスクでのみ使うようにしてください（課金の増幅にご注意ください）。
</Tip>

## 課金メモ: 推論トークン

`grok-4.5` / `grok-4.3` / `grok-build-0.1` **デフォルトでは内部で推論します**: レスポンスには`reasoning_content`が含まれ、推論 token は出力の課金対象に含まれます。テストでは、短い回答で表示された token はわずか 30 でしたが、課金された出力 token は 586 でした（そのうち 556 が推論分でした）。コストに敏感な短いQ\&Aでは、`grok-4.20-0309-non-reasoning`に切り替えてください。詳細は[Chat & Reasoning](/ja/api-capabilities/grok/chat)です。

## よくある質問

<AccordionGroup>
  <Accordion title="Grok には独自のネイティブ API 形式がありますか？">
    独自の専用プロトコルはありません。xAI の公式 REST API は OpenAI 互換です: `/v1/chat/completions`（chat）と `/v1/responses`（Responses API とサーバーサイドツール）です。OpenAI SDK を `https://api.apiyi.com/v1` に向ければ、完全な機能セットが使えます — 「互換モードへの機能縮小」はありません。
  </Accordion>

  <Accordion title="Web 検索を有効にするにはどうすればよいですか？">
    Responses API を使います: `tools: [{"type": "web_search"}]`（または `x_search`）。Chat Completions 上の旧 `search_parameters` フィールドは xAI によって削除されました（410 が確認済み）— 使用しないでください。[Web & X 検索](/ja/api-capabilities/grok/web-search) を参照してください。
  </Accordion>

  <Accordion title="モデルが自分を Grok 4 と名乗ります — リクエスト先のモデルを間違えていますか？">
    これは正常です。Grok 4.x のすべてのモデルは、単に「Grok 4」と自己名乗りします（マルチエージェントモデルは自らを Oppie と呼びます）し、4.5 / 4.3 のような正確なバージョン番号は返しません。モデルの自己紹介ではなく、リクエストとレスポンス内の `model` フィールドで識別を確認してください。
  </Accordion>

  <Accordion title="キャッシュに設定は必要ですか？">
    いいえ。Grok の prefix caching は自動です。ヒットは `usage.prompt_tokens_details.cached_tokens` で確認できます（テストでは、同一プレフィックスの 2 回目のリクエストで 2688/2735 tokens がヒットしました）。ゲートウェイは key-pool モードで動作するため、ヒット率には適切な期待値を設定してください — [キャッシュ課金](/ja/faq/cache-billing) を参照してください。
  </Accordion>

  <Accordion title="コンテキストウィンドウを超えるとどうなりますか？">
    400 エラーです。モデルごとに上限は異なります: grok-4.5 は 500K、grok-4.3 と 4.20 シリーズは 1M、grok-build-0.1 は 256K です。長い内容は、要約する、チャンクに分割する、または RAG retrieval を使ってください。
  </Accordion>

  <Accordion title="失敗したリクエストにも課金されますか？">
    4xx のクライアントエラー（不正なパラメータ / 認証失敗）は課金されません。token を正常に返したリクエストは、実際の使用量に応じて課金されます。なお、`deferred: true` は黙って無視されます — 実際には同期的に実行され、通常どおり課金されます。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="チャットと推論" icon="message-square" href="/ja/api-capabilities/grok/chat">
    ストリーミング、chain-of-thought、構造化出力、関数呼び出し、ビジョン、キャッシング
  </Card>

  <Card title="Web と X Search" icon="globe" href="/ja/api-capabilities/grok/web-search">
    Responses API の web\_search / x\_search ツールをハンズオンで解説
  </Card>

  <Card title="コード実行と MCP" icon="terminal" href="/ja/api-capabilities/grok/code-execution-mcp">
    サーバーサイドの Python サンドボックスと Remote MCP の統合
  </Card>

  <Card title="マルチエージェントモデル" icon="users" href="/ja/api-capabilities/grok/multi-agent">
    マルチエージェントモデルの機能と課金プロファイル
  </Card>

  <Card title="Codex で Grok を使う" icon="code" href="/ja/scenarios/programming/codex-cli">
    ネイティブな responses プロトコル、5 分で Codex に接続
  </Card>

  <Card title="Grok 4.5 ローンチのディープダイブ" icon="newspaper" href="/en/news/grok-4-5-launch">
    xAI の最新フラッグシップを詳しく解説
  </Card>

  <Card title="モデル情報" icon="database" href="/ja/api-capabilities/model-info">
    利用可能なすべてのモデルとグループ
  </Card>
</CardGroup>