3行でいうと
- APIで「まず選ぶ1つ」は、公式が旗艦モデルとして挙げる
grok-4.7（文脈の長さ500k）です。コーディング専用のgrok-build-0.1や、文脈が1Mのgrok-4.3なども並んでいて、公式の料金表で入力・出力の単価を比べられます。 - アプリやGrok Buildの使用量は、有料プランだと「週ごとの共有プール」の考え方です。使い切ると追加クレジット（Additional Usage）になります。プランごとの具体的な量は、僕らが読んだ公式ページには数字で書かれていませんでした。
- APIの入口は console.x.ai でのサインアップとクレジットの追加、APIキーの作成、環境変数
XAI_API_KEYです。基本の呼び先はhttps://api.x.ai/v1で、新しく書くなら Responses API が前提です。
この記事は公式ドキュメントを2026年10月22日に読んでまとめたもので、実際に使って確かめた記録ではありません。運営者はGrokを入れていますが、使い心地はこの記事には書いていません。モデル名、価格、上限、プラン名は公式の表記のとおりに写しています。公式の表示は変わることがあります。公式の文章は要約として取得したため、読み切れていない箇所は「読んだ範囲では見つからなかった」と書いています。
先に結論
- 入口は4つに分かれています。 公式ドキュメントの上部メニューは、Grok（チャットのアプリ）、Grok Build（コーディング用のCLI）、Grok Bot（クラウド上のAI同僚）、X Subscription（サブスク）、それにAPIを並べています。この記事の「モデルの選び方」は主にAPI向けで、アプリのモデル選択は別に書きます。
- APIで迷ったら、公式の推奨から始めます。 Modelsのページは
grok-4.7を「最も高性能」と位置づけ、コードとチャットに勧めています。ただし、これは公式の勧めであって、あなたの用途で最適かどうかは別の話です。 - 「使用量」は2種類あります。 サブスク側の「週ごとの使用量プール」と、API側の「ティアごとのレート制限＋従量課金」です。両者の関係は、僕らが読んだ範囲では1つの説明にまとまっていませんでした（後半の「くわしく」を参照）。
- 料金は公式の表のとおりに見ます。 単価は「100万トークンあたり」で、入力・キャッシュ入力・出力に分かれ、プロンプトが200k以上だと単価が上がります。ツールの呼び出し料金は別に表があります。
前提：用語をそろえる
- トークン：文章を数える単位です。入力（こちらが送る分）と出力（モデルが返す分）で単価が違います。
- コンテキストウィンドウ（文脈の長さ）：1回のやりとりで、モデルが一度に扱える量の上限です。表の「500k」「1M」がこれにあたります。
- キャッシュ入力：同じ前置きを繰り返し送るとき、安い単価で数えられる入力です。公式の料金表に別の列があります。
- reasoning_effort：推論にかける深さを指定するAPIの項目です。モデルによって使える値が違います（後述）。
- RPSとTPM：レート制限の単位です。RPSは1秒あたりの要求数、TPMは1分あたりのトークン数です。
- Responses API：xAIが前提にしているAPIの形です。公式は、Chat Completionsを「Legacy（古い方式）」の扱いにしています。
- ティア：累計の支払額に応じて自動で上がる、APIの上限の段階です（Tier 0〜Tier 4、別にEnterprise）。
モデルの選び方（API）
公式が並べているテキストモデル
次の表は、docs.x.ai の「Pricing」と「Models」のテキストモデルの表をまとめたものです。価格は「100万トークンあたり」、ドル表記（$）です。長い入力（プロンプトが200k以上）のときの単価は、別の列にあります。
| モデル | 文脈 | 入力 | キャッシュ入力 | 出力 | 200k以上の入力 | 200k以上の出力 |
|---|---|---|---|---|---|---|
| grok-4.7 | 500k | $2.00 | $0.50 | $6.00 | $4.00 | $12.00 |
| grok-build-0.1 | 256k | $1.00 | $0.20 | $2.00 | $2.00 | $4.00 |
| grok-4.6 | 500k | $2.00 | $0.50 | $6.00 | $4.00 | $12.00 |
| grok-4.5 | 500k | $2.00 | $0.30 | $6.00 | $4.00 | $12.00 |
| grok-4.3 | 1M | $1.25 | $0.20 | $2.50 | $2.50 | $5.00 |
| grok-4.20-0309-reasoning | 1M | $1.25 | $0.20 | $2.50 | $2.50 | $5.00 |
| grok-4.20-0309-non-reasoning | 1M | $1.25 | $0.20 | $2.50 | $2.50 | $5.00 |
| grok-4.20-multi-agent-0309 | 1M | $1.25 | $0.20 | $2.50 | $2.50 | $5.00 |
長い入力の単価は、リクエストのプロンプトが200kトークンに達すると、そのリクエストの全トークンに適用される、と公式は書いています。200k以上のときのキャッシュ入力の単価は、Pricingの表に別の列があります（この表では省きました）。
公式の書き方から読めること
grok-4.7：公式は「コードやそれ以外すべてのための旗艦モデル」と説明しています。テキストと画像を入力でき、出力はテキストです。知識の期限（knowledge cutoff）は2026年5月、reasoning_effortはlow、medium、high（既定）、xhighです。使えるツールは、関数呼び出し、Web検索、X検索、コード実行と書かれています。grok-build-0.1：公式の説明は、エージェント型のソフトウェア開発向けのコーディングモデルです。文脈は256k、テキストと画像を入力でき、関数呼び出し、構造化出力、推論に対応します。Batch APIは非対応と書かれています。grok-4.20-multi-agent：ベータ（beta）と書かれています。複数のエージェントが分担して調べ、リーダーが最終回答をまとめる形で、エージェント数は4か16です。ベータなので、公式は仕様が変わりうると書いています。grok-4.7の「Fast」：同じモデルを速い基盤で動かすもので、料金は標準の2倍（長い入力では1.5倍）と書かれています。使えるのはCursorとGrok Buildだけで、公開のxAI APIにはありません。- 選び方の目安（僕らの整理）：まずは公式の勧める
grok-4.7。コストを下げたいなら、単価が低いgrok-4.3やgrok-build-0.1を、同じ課題で比べます。「どれが賢いか」の比較は、僕らが読んだ公式ページには見つかりませんでした。
推論の深さ（reasoning_effort）
公式のReasoningのページには、次の対応が書かれています。
| モデル | 指定できる値 | 備考 |
|---|---|---|
| grok-4.7、grok-4.6 | low、medium、high（既定）、xhigh | 推論は無効にできない、と書かれています |
| grok-4.5 | low、medium、high（既定） | xhigh は high として扱われます |
| grok-4.20-multi-agent | low、medium、high、xhigh | ここでは推論の深さではなく、協力するエージェントの数（4か16）を決めます |
推論に使われたトークンも請求の対象で、使用量の reasoning_tokens に出ます。presencePenalty、frequencyPenalty、stop を付けると、推論モデルではエラーになる、とも書かれています。
別名と、なくなったモデル
- 別名の決まりは3つです。
<モデル名>は最新の安定版、<モデル名>-latestは新機能を含む最新版、<モデル名>-<日付>は固定された版です。公式はほとんどの人に、日付なしか-latestを勧めています。ただし、どのモデルに別名があるかの一覧は、読んだページには見つかりませんでした。 - 2026年5月15日12:00（太平洋時間）に、8つのモデルがAPIから退役しました（
grok-3、grok-4-0709、grok-code-fast-1など）。旧名は引き続き解決され、新しいモデルへリダイレクトされます。公式は、退役後に旧名へ送った分はgrok-4.3の料金で請求されるので、新しいモデル名を明示するよう勧めています。 - 画像モデルの
grok-imagine-image-qualityは2026年11月2日に退役し、grok-imagine-image-2.0に移ると書かれています（Release Notesと移行ガイドの題名による）。
画像、動画、音声のモデル
Modelsのページは、画像には grok-imagine-image-2.0、動画には grok-imagine-video-1.5 を勧めています。音声は Grok Voice で、Release Notesによると2026年10月に grok-voice-3.0 が出て、grok-voice-2.0 は非推奨（deprecated）になりました。単価は後の「公式の料金表示」にまとめます。
使用量の考え方
サブスク側：週ごとの共有プール
Grokの公式FAQは、2026年6月に展開中として、有料ユーザーに「どのGrok製品にも使える、共有の週ごとの使用量プール」がある、と書いています（製品ごとの日次の上限に代わるもの、とあります）。読んだ範囲で分かることは次のとおりです。
- 週ごとにリセットされます。リセットの日程は、アプリの Settings → Usage に出ると書かれています。
- 使用量は割合（%）で出て、API、Build、Chat、Imagine、Voice の内訳が分かります。
- 無料枠のChatとVoiceの上限は、別枠で、別のスケジュールでリセットされます。
- 上限に達したら、追加のクレジット（Extra Usage Credits）を買う、プランを上げる、自動チャージ（Auto Top Up）を有効にする、の3つが選べます。FAQは、Web版で5ドルから買え、購入の1年後に失効すると書いています。
- 720pの動画は、そのプランの720pの上限に達すると480pに下がる、とあります。
The X Subscription の「Usage limits」のページは、有料の席ごとに「第一者（first-party）の利用に限った週ごとのプール」があり、その分を使い切ると有料の追加利用（Additional Usage）になる、と説明しています。プールは、対応するGrokとCursorの画面で共有されます。サードパーティのモデル（CursorのClaudeやGPTなど）はこのプールに入らず、最初の1回から追加利用の扱いになります。プランごとの具体的な量（回数やトークン）は、このページには書かれていません。「上位のプランほどプールが大きい」「最新の量は x.ai/pricing を見る」とだけあります。
The X Subscription のプランと価格（docs.x.ai の表示）
「Plans and usage」のページには、次のプランが書かれています。通貨のコードは書かれておらず、「$」の表示で、消費税は別です。
| プラン | 月払い | 年払い | 含まれる使用量の表示 |
|---|---|---|---|
| Free | $0 | $0 | Limited |
| Plus | $8 | $80（月あたり$7） | Base |
| Premium | $30 | $300（月あたり$25） | 4x |
| Super | $100 | $1,000（月あたり$84） | 15x |
| Ultra | $200 | $2,000（月あたり$167） | 50x |
チーム向けは、席ごとにPremium $30、Super $100、Ultra $200で、Plusはありません。「4x」「15x」「50x」は、「Base（Plus）を基準にした倍率」と読めますが、何の単位の倍率かは、このページでは説明されていませんでした。日本円の価格は、読んだ範囲では見つかりませんでした。
同じ公式の中で、プランの名前が揃っていません
僕らが読んだ公式の3か所で、プランの名前が違っています。どれが最新かを僕らは判断できないので、並べておきます。
- docs.x.ai の X Subscription：Free、Plus、Premium、Super、Ultra。既存のCursor、SuperGrok、X Premiumのプランは、変えるまで続く、と書かれています。
- x.ai/pricing：Free（$0/月）と SuperGrok（$30/月）に価格があり、SuperGrok Lite、SuperGrok Heavy、Business、Enterpriseは比較表に名前だけが出ていました。表は崩れて取得されたので、どの機能がどの段かは読み取れていません。
- Grokのドキュメントのトップとfaq：Free、SuperGrok、SuperGrok Heavy（年払い）、X Premium が出てきます。
ページの更新日がページ内で確認できなかったものもあります。契約の前には、必ず公式のそのときの料金ページを見てください。
API側：ティアとレート制限
APIの上限は、チーム（team）ごと、モデルごとにあり、1秒あたりの要求数（RPS）と1分あたりのトークン数（TPM）の2軸です。超えるとHTTP 429が返ります。ティアは、2026年1月1日以降の累計のxAI APIの支払い額で、自動で上がり、下がることはありません。
| ティア | 累計の支払額のしきい値 |
|---|---|
| Tier 0 | $0（既定） |
| Tier 1 | $50 |
| Tier 2 | $250 |
| Tier 3 | $1,000 |
| Tier 4 | $5,000 |
| Enterprise | 要相談 |
テキストモデルの上限（Tier 0からTier 4の順）は、公式のRate Limitsのページでは次のとおりです。
| モデル | RPS | TPM |
|---|---|---|
| grok-4.7、grok-4.6、grok-4.5 | 150、172、208、312、500 | 50M、53M、60M、74M、100M |
| grok-4.3、grok-4.20-0309-reasoning、grok-4.20-0309-non-reasoning、grok-build-0.1 | 37、50、75、125、208 | 10M、15M、25M、45M、85M |
| grok-4.20-multi-agent-0309 | 9、12、18、31、56 | 2.5M、3.7M、6.2M、11M、21M |
自分のチームの実際の上限は、xAI ConsoleのModelsページで見る、と書かれています。上限を上げたいときは、支払いを増やす（ティアが上がる）、Consoleで引き上げを依頼する、sales@x.ai に連絡する、の3つです。公式は429の対策として、待ち時間を伸ばして再試行する（指数バックオフ）ことを勧めています。レート制限の応答ヘッダーは、そのページには書かれていませんでした。
サブスクの「API」の内訳と、APIの課金の関係
Grok FAQの使用量の内訳には「API」の項目があります。一方、APIは前払いクレジット（console.x.aiで追加）と従量課金で動くと、クイックスタートに書かれています。FAQの「API」の項目が、どの範囲の使い方を指すのか、サブスクのプールとAPIの前払いクレジットがどうつながるのかは、僕らが読んだ範囲では説明が見つかりませんでした。FAQは、xAI APIのクレジットは返金できない、とも書いています。
APIの入口
公式のQuickstartに書かれている流れです（ページの更新日として2026年10月10日が表示されていました）。
- サインアップとクレジット。 console.x.ai でアカウントを作り、APIを使う前にクレジットを追加します。
- APIキーの作成。 コンソールの「API Keys」のページで作ります。
- 環境変数。
export XAI_API_KEY="your_api_key"（シェル）か、プロジェクトの.envにXAI_API_KEY=your_api_keyと書きます。 - 呼び先。 ベースURLは
https://api.x.ai/v1です。テキストはPOST https://api.x.ai/v1/responses、画像はPOST https://api.x.ai/v1/images/generationsが例に出ています。 - SDK。 OpenAIのSDK（
pip install openai、npm install openai）をhttps://api.x.ai/v1に向けて使えます。xAI専用はpip install xai-sdk、JavaScriptのAI SDKはnpm install ai @ai-sdk/xai zodです。
OpenAIのSDKの例には、キーの置き場所を示す <YOUR_XAI_API_KEY_HERE> があります。Quickstartには注意書きの専用の節はありませんが、キーをコードに書かず、環境変数か .env に置く形で例が書かれています。その注意は、データとプライバシーのFAQにあります（後述）。
公式の入口になるページ
- Overview（docs.x.ai/overview）：製品の入口です。Grok 4.7、Voice API、Imagine API、Responses APIが並びます。
- Models、Pricing、Rate Limits：モデル、料金、上限です。
- Release Notes：月単位の更新です。2026年10月のものには、Grok Voice 3.0などがありました。
- REST Reference、llms.txt、OpenAPI：機械向けの一覧は、docs.x.ai の
llms.txtに、ページの一覧とopenapi.jsonが載っています。 - Docs MCP：ドキュメントを、AIのクライアントから読ませる公式のMCPサーバー（
https://docs.x.ai/api/mcp）です。詳しくは04の記事で書きます。 - 地域別のエンドポイント：既定は
https://api.x.aiで、処理される地域は保証されません。米国向けのhttps://us.api.x.ai/v1は、grok-4.7とgrok-4.6だけで、トークンの料金が10%高い、と書かれています。画像、動画、音声は米国のエンドポイントにありません。公式は、これが包括的なデータ所在地の保証ではないとも書いています。
公式の料金表示
金額は、すべて公式のPricingのページに書かれたものです。ドル表記（$）で、日本円の表示は見つかりませんでした。2026年10月22日に読んだ内容で、変わることがあります。
倍率と割引（テキストモデル）
| 項目 | 公式の書き方 |
|---|---|
| Batch API | 対応する grok-4.7、grok-4.6、grok-4.5、grok-4.3、grok-4.20 の各モデルで20%引き。入力、出力、キャッシュ、推論のトークンに適用。画像と動画は標準の料金 |
| Priority Processing | 全トークン種別で標準の2倍。応答に "service_tier": "priority" が出たときだけ、その料金で課金。画像、動画、Batch APIでは使えません |
| 米国のエンドポイント | グローバルの1.1倍（grok-4.7と grok-4.6のみ） |
| 長い入力（200k以上） | 上の表の「200k以上」の単価 |
| Grok 4.7 Fast | 200k未満で入力$4.00、キャッシュ$1.00、出力$12.00（CursorとGrok Buildのみ） |
ツールの呼び出し料金
| ツール | 公式の価格表示 |
|---|---|
| Web Search | $5 / 1k calls |
| X Search | $5 / 1k posts、$10 / 1k profiles |
| Code Execution | $5 / 1k calls |
| File Attachments（attachment_search） | $5 / 1k calls |
| Collections Search（file_search） | $2.50 / 1k calls |
| Image Generation | Imagine APIの料金 |
| Image Understanding、X Video Understanding、Remote MCP | トークン課金のみ（呼び出し料金なし） |
トークンの料金と、ツールの呼び出し料金は別に数えられます。X Searchだけは、呼び出しの回数ではなく、取得した投稿とプロフィールの数で請求される、と書かれています。
画像、動画、音声
Imagineの料金は、モデルごと、解像度ごとに表があります。たとえば、Modelsのページは、画像に grok-imagine-image-2.0（$0.04/枚と表示）、動画に grok-imagine-video-1.5（$0.080/秒と表示）を勧めています。Pricingのページでは、grok-imagine-image の出力が$0.02/枚、grok-imagine-image-2.0 の出力が解像度と品質の段階により$0.04〜$0.08/枚、grok-imagine-video-1.5 が480pで$0.08、720pで$0.14、1080pで$0.25（いずれも1秒あたり）でした。Pricingのページには、解像度や品質の段階ごとの、さらに細かい表があります。そのページの入力欄の一部は崩れて取得されたので、細かい数字は公式のページで直接見てください。音声は、Speech to Speechが$0.08/分、Speech to Textが$0.10/時（REST）と$0.20/時（ストリーミング）、Text to Speechが100万文字あたり$15.00です。
自分の使った分の見かた
- リクエストごと：応答の
usageの中にcost_in_usd_ticksがあります。割り算で、ドルになります（10,000,000,000で割る）。割引後の金額で、トークンとサーバー側ツールの料金を含みます。公式の例では、37756000が約$0.0038です。 - 積み上げ：この値はリクエストごとで、会話のターンをまたいで積み上がりません。合計は自分で足します。
- ストリーミング：OpenAI SDKやRESTでは
stream_options: { include_usage: true }を付けると、最後のチャンクに出ます。 - キャッシュ：キャッシュに当たった量は
cached_tokensで分かります。公式は、同じ会話のリクエストにはx-grok-conv-idヘッダーを付けるのを勧めています。Responses APIではprompt_cache_keyが同じ役目として書かれています（どちらをどのAPIで使うかは、読んだページでは明示されていませんでした）。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。運営者はGrokを入れていますが、使い心地はこの記事には書いていません。公式ドキュメントを読んだ範囲です。
- 価格、上限、プラン名、モデル名は、公式ページに書かれていた2026年10月22日時点の表示です。公式の中でも、プラン名の表示がそろっていません（上の「くわしく」）。契約の前に、そのときの公式の料金ページを見てください。
- プランごとの使用量の「量」は、僕らが読んだ公式ページには数字で書かれていませんでした。「4x」「15x」「50x」の表示の意味は、確かめられていません。
- 公式サイトの運営会社名の表記は、docs.x.ai では「SpaceXSI」でした。X Helpのページには「SpaceXAI」という表記もあります。
- データの扱いは、公式のデータとプライバシーのFAQによると、APIの入力と出力を、明示の許可なしに学習に使うことはなく、既定ではリクエストとレスポンスを30日間保存してから削除する、と書かれています。ゼロデータ保持（ZDR）はチーム全体の設定で、有効にすると、状態を保存するResponses API、ファイルとコレクション、Batch APIなどが使えなくなる、とも書かれています。法的な助言ではありません。契約と最新の規約は、公式の文書で確かめてください。
- APIキーについて、公式は、パスワードのように扱い、環境変数かシークレット管理に入れ、リポジトリにコミットせず、定期的に入れ替える、と書いています。漏れた疑いがあるときは、コンソールで無効にして作り直します。
- アプリの上限（週ごとのプール）と、APIの上限（ティアごとの制限）は、別の仕組みとして説明されています。片方の数字を、もう片方に当てはめないでください。
- 公式の文章は要約の形で取得したため、長い引用はせず、言い換えています。
出典
- Grok API Documentation: Overview（docs.x.ai、2026年10月22日確認）
- Models（docs.x.ai、ページ表示の更新日 2026年9月21日、10月22日確認）
- Pricing（docs.x.ai、10月22日確認）
- Grok 4.7（docs.x.ai、10月22日確認）
- Grok Build 0.1（docs.x.ai、10月22日確認）
- Reasoning（docs.x.ai、10月22日確認）
- Multi Agent（docs.x.ai、10月22日確認）
- Rate Limits（docs.x.ai、10月22日確認）
- Quickstart（docs.x.ai、ページ表示の更新日 2026年10月10日、10月22日確認）
- Release Notes（docs.x.ai、10月22日確認）
- Model Retirement（May 15, 2026）（docs.x.ai、10月22日確認）
- Cost Tracking（docs.x.ai、10月22日確認）
- Batch API（docs.x.ai、10月22日確認）
- Priority Processing（docs.x.ai、10月22日確認）
- Prompt Caching: Usage & Pricing（docs.x.ai、10月22日確認）
- Regional Endpoints（docs.x.ai、10月22日確認）
- Data & Privacy FAQ（docs.x.ai、10月22日確認）
- Plans and usage: Pricing（The X Subscription、docs.x.ai、10月22日確認）
- Usage limits（The X Subscription、docs.x.ai、10月22日確認）
- Extra usage credits and top-ups（The X Subscription、docs.x.ai、10月22日確認）
- Spending caps and alerts（The X Subscription、docs.x.ai、10月22日確認）
- Grok: Help & FAQ（docs.x.ai、10月22日確認）
- Grok: Get Started（docs.x.ai、10月22日確認）
- SuperGrok pricing（x.ai、10月22日確認）
- llms.txt（docs.x.ai、10月22日確認）