結論

Grok API は、Grok のモデル(2026年11月18日時点の主力は grok-4.7)をプログラムから呼ぶための有料の API です。console.x.ai でクレジットを入れて API キーを作り、環境変数 XAI_API_KEY に置いて、OpenAI SDK の base_url を https://api.x.ai/v1 に変えれば Python から呼べます。

この記事でわかること

  • モデル一覧・料金表(20万トークンを境に単価が倍)と月の費用の試算
  • OpenAI SDK・xai_sdk が実際に送るリクエストの形(模擬サーバーで取得)
  • 401・404・429 などのエラーと、SDK の再試行の動き

2026年11月18日更新|openai 3.55.0・xai-sdk 1.21.0・Python 3.13 で模擬サーバーに送って確認

この記事で実際に動かしたもの:127.0.0.1 の模擬サーバー(HTTP と gRPC)に、OpenAI SDK・xai_sdk・curl から Grok API と同じ形のリクエストを送り、送信の中身・ストリーミング・エラー・再試行を確かめました。料金の試算も Python で計算しています。

flowchart TD
    A[自分のプログラム] --> B{どの SDK?}
    B -->|OpenAI SDK| C[HTTPS<br>api.x.ai/v1/responses]
    B -->|xai_sdk| D[gRPC<br>api.x.ai]
    C --> G[grok-4.7 など]
    D --> G

よく調べられることの答えを先にまとめます。

知りたいこと 答え 詳しい節
Grok API とは Grok のモデルを自分のアプリから呼ぶ API。トークン単位の従量課金 Grok API とは
Grok API の料金 grok-4.7 は入力 $2.00・出力 $6.00(100万トークンあたり、20万未満) Grok API の料金
Grok API は無料か 料金・請求のページに無料のクレジットの記載は無かった。前払いのクレジットから引かれる Grok API の料金
Grok API キーの取り方 console.x.ai に登録→クレジットを入れる→API Keys のページで作る Grok API キーの取り方
Python での呼び出し OpenAI SDK の base_url を変える。または xai_sdk を使う Python での呼び出し
429 が出た レート制限。待ってから再試行。上限は累計の支払額で上がる エラーとレート制限
X API との違い X API は X の投稿やアカウントを扱う API。Grok API は AI のモデルを呼ぶ API X API・Groq との違い

確認環境:Ubuntu 24.04.5 LTS の Python 3.13.18 に venv を作り、openai(Python SDK)3.55.0 と xai-sdk 1.21.0(grpcio 1.85.3)を入れました。公式ドキュメントの応答の形をまねた HTTP の模擬サーバーと、xai_sdk に同梱の gRPC の定義で作った模擬サーバーを 127.0.0.1 に立て、SDK と curl 8.5.0 から送って、送信の中身・例外・再試行を確かめました。本物の Grok API には接続しておらず、ログイン・API キーの作成・課金もしていません(キーは架空の文字列、環境は env -i で外の設定を外しています)。モデルの返す文章とエラーの文面は模擬サーバーの自作です。モデル名・料金・上限・エラー・データの扱いは公式ドキュメント(docs.x.ai)の記載です。図は mermaid 11.16.0 で描画を確かめています(確認日 2026年11月18日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「Grok APIの使い方|xAIのAPIキー・料金・Pythonでの呼び出し」

Grok API とは(できること・提供元の名前)

この節では、Grok API で何ができるのかと、公式ドキュメントでの提供元の呼び方が分かります。

Grok API は、対話 AI「Grok」と同じ系統のモデルを、自分のプログラムや業務システムから呼び出すための API です。 文章の生成のほか、画像の理解、画像・動画の生成、音声(読み上げ・文字起こし・音声での対話)、Web 検索や X の検索を組み合わせたツール呼び出しまで、公式ドキュメントに機能が並んでいます。

  • 提供元の表記:Grok は xAI が開発した AI として知られていますが、2026年11月18日時点の公式ドキュメントのサイト名は「SpaceXSI Docs」で、クイックスタートは「SpaceXSI API」を Grok のモデルの公式の API と説明しています。一方で、ドメイン(x.ai・api.x.ai・console.x.ai)、SDK の名前(xai_sdk)、環境変数(XAI_API_KEY)は x.ai・xai のままです。
  • 呼び出し口:基本の URL は https://api.x.ai/v1 です。文章の生成は Responses API(/v1/responses)が中心で、Chat Completions(/v1/chat/completions)は公式に「legacy(以前からの)エンドポイント」と書かれています。
  • SDK:クイックスタートでは xAI SDK(pip install xai-sdk)、OpenAI SDK(pip install openai・npm install openai)、Vercel AI SDK(@ai-sdk/xai)が案内されています。

Grok API と X API・Grok(アプリ)・Groq の違い

この節では、名前が似ているサービスとの違いが分かります。

Grok API は「AI のモデルを呼ぶ API」で、X の投稿やアカウントを扱う X API とは目的が別です。 grok.com や X の中で使う Grok(アプリ)とも、契約と料金の仕組みが分かれています。

名前 何をするものか 料金の考え方
Grok API Grok のモデルをプログラムから呼ぶ トークン・回数の従量課金(前払いのクレジット)
Grok(grok.com・アプリ) 人が画面で Grok と対話する アプリ・X の購読の料金(API とは別)
X API X の投稿・ユーザー・検索をプログラムで扱う X の開発者向けの料金
Groq 別の会社の AI 推論サービス(名前が似ているだけ) Groq の料金

Grok API の X Search を使うと、X の投稿を検索した結果をもとにモデルが答えます。X に投稿する・X のデータを直接取得する用途は X API の役割です(記事「X API(旧Twitter API)の使い方|料金・キーの取得・Pythonで投稿」の題材です)。名前の似た Groq については、記事「Groqとは|LPUで速いAI推論・使い方・料金とAPIの呼び出し方」にまとめています。

Grok API のモデル一覧(2026年11月18日時点)

この節では、Grok API で指定できるモデル名と、それぞれの文脈の長さが分かります。

文章のモデルは、公式の料金ページに次の8つが並んでいました。 公式のモデルのページは grok-4.7 を「コードとそれ以外のすべてに向けた主力(flagship)」と説明しています。

モデル名(model に書く値) 文脈の長さ メモ(公式の記載)
grok-4.7500k主力。2026年9月21日に提供開始。知識の区切りは2026年5月
grok-4.6500k2026年8月12日に提供開始
grok-4.5500k2026年7月8日に提供開始
grok-4.31M5月15日に退役したモデルの転送先
grok-4.20-0309-reasoning1M推論あり
grok-4.20-0309-non-reasoning1M推論なし
grok-4.20-multi-agent-03091M複数のエージェントで答える
grok-build-0.1256kコーディング向け(Grok Build)
  • 別名の決まり:公式は「<モデル名> は最新の安定版、<モデル名>-latest は最新版、<モデル名>-<日付> は特定のリリース」を指すと説明しています。挙動を固定したいときは日付つきの名前を使います。
  • 画像・動画・音声:grok-imagine-image-2.0・grok-imagine-video-1.5・Grok Voice(2026年10月14日から grok-voice-latest は grok-voice-3.0 を指す)です。

退役したモデル名と移行先

以前の記事に出てくる grok-3 や grok-4-0709 は、2026年5月15日に退役しました。公式の移行ガイドによると、以前の名前のままでもリクエストは転送先で処理されますが、転送先の単価で課金されます。

退役したモデル 5月15日以降の転送先
grok-4-1-fast-reasoning・grok-4-fast-reasoning・grok-4-0709grok-4.3(推論の深さ low)
grok-4-1-fast-non-reasoning・grok-4-fast-non-reasoning・grok-3grok-4.3(推論の深さ none)
grok-code-fast-1grok-build-0.1

移行ガイドは、model を書き換え、推論の深さ(none〜high)を自分で指定することを勧めています。

Grok API の料金(公式の料金表)

この節では、Grok API の料金表と、ツール・Batch・地域ごとの追加の決まりが分かります。

文章のモデルは、入力・キャッシュされた入力・出力のトークン数で課金されます。 プロンプトが20万トークン(200k)を超えるリクエストは、そのリクエストの全トークンが長文の単価になります(公式:長文の単価のあるモデルは、リクエストのすべてのトークンを長文の単価で請求)。

モデル 入力 キャッシュ入力 出力 20万超の入力/出力
grok-4.7・grok-4.6$2.00$0.50$6.00$4.00/$12.00
grok-4.5$2.00$0.30$6.00$4.00/$12.00
grok-4.3・grok-4.20 系$1.25$0.20$2.50$2.50/$5.00
grok-build-0.1$1.00$0.20$2.00$2.00/$4.00

単位は100万トークンあたりの米ドルです(2026年11月18日時点の公式の料金ページ。ページの最終更新は2026年10月10日)。

追加の料金・割引 公式の記載
Web Search・Code Execution1,000回あたり $5(トークンの料金は別)
X Search取得した投稿1,000件あたり $5、プロフィール1,000件あたり $10
Batch APIgrok-4.7・4.6・4.5・4.3・4.20 系は20%引き
優先処理(Priority Processing)通常の2倍。応答に "service_tier": "priority" が付いたときだけ
US の地域のエンドポイント通常の1.1倍(grok-4.7・grok-4.6 だけ)
画像の生成grok-imagine-image-2.0 は 1K Low で1枚 $0.04 から
利用のガイドラインで生成前に止められたリクエスト1件 $0.05(Responses API)

無料で使えるか・支払いの仕組み

公式の料金と請求(Billing)のページには、無料のクレジットの記載は見つかりませんでした。 請求のページにあったのは次の内容です。

  • チーム単位でクレジットを前払いし、API の使用分がそこから引かれる。前払いのクレジットが無くなると、API のリクエストは自動で断られる。
  • 残高が決めた額を下回ったら自動で買い足す設定(Auto top-up、最低 $5)がある。
  • 請求書払い(invoiced billing)は既定で無効で、上限は $0。営業窓口への申し込みが要る。

Grok API の料金の計算(手元で計算した試算)

この節では、公式の単価から1回・1か月の費用を計算した結果と、20万トークンの境目で費用がどう変わるかが分かります。

1回あたり入力2,000・出力500トークンを grok-4.7 で1万回送ると、月 $70 になりました。 上の料金表の単価を Python の関数(20万超の切り替え・キャッシュ・Batch・優先処理・US の倍率を入れたもの)に入れて計算しました。

条件 費用(米ドル)
grok-4.7・1回(入力2,000・出力500)$0.0070
grok-4.7・1万回/月$70.00
1万回/月・入力のうち1,500がキャッシュに当たる$47.50
1万回/月・Batch API(20%引き)$56.00
1万回/月・US のエンドポイント(1.1倍)$77.00
1万回/月・優先処理(2倍)$140.00
1万回/月・Web 検索を毎回3回(ツールの分だけ)$150.00
$70grok-4.7 で1万回/月入力2,000・出力500 トークン
2.0倍20万トークンの境目入力199,000→201,000 で $0.404→$0.816
32%キャッシュで下がる費用入力の75%が一致したとき $70→$47.5

長い文書を丸ごと渡すときは、20万トークンの境目に注意が要ります。 入力199,000・出力1,000なら1回 $0.404 ですが、入力201,000では全トークンが長文の単価になり $0.816 と約2倍でした。検索ツールの料金はトークンとは別に回数でかかるため、検索を多用するとツールの分がトークンの分を上回ります。日本語の文章が何トークンになるかの目安は、関連記事「トークンとは|生成AIの数え方・日本語の文字数目安と節約方法」で扱っています。

Grok API キーの取り方(画面の流れ)

この節では、API キーを作るまでの流れと、キーの扱いで気をつける点が分かります。

公式のクイックスタートの流れは、登録→クレジット→キーの作成→環境変数の4段階です。 この記事ではログインしていないため、画面の名前はクイックスタートの記載にある語だけを書いています。

1

console.x.ai に登録する

公式のコンソール(console.x.ai)でアカウントを作ります。チームの単位で請求とキーを管理します。

コンソール

2

クレジットを入れる

前払いのクレジットを入れます。残高が無いとリクエストは断られます。自動の買い足し(最低 $5)も選べます。

Billing

3

API Keys のページでキーを作る

作った直後にキーを控えます。Management API の説明では、作成後はキーの全体を表示せず、キーごとに使えるモデル・エンドポイント(ACL)や上限(qpm・tpm)、有効期限を持てます。

API Keys

4

環境変数に置く

export XAI_API_KEY="..." か、プロジェクトの .env に XAI_API_KEY=... と書きます。コードに直接書かないようにします。

XAI_API_KEY

Python での呼び出し(OpenAI SDK・Responses API)

この節では、OpenAI SDK で Grok API を呼ぶコードと、SDK が実際に送る中身が分かります。

OpenAI SDK は、api_key と base_url を変えるだけで Grok API に向けられます。 公式のクイックスタートと同じ形で、Responses API を呼ぶコードです。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url=os.environ.get("XAI_BASE_URL", "https://api.x.ai/v1"),
)
response = client.responses.create(
    model="grok-4.7",
    input=[{"role": "user", "content": "Grok API の要点を1文で"}],
    max_output_tokens=200,
)
print(response.output_text)
print(response.usage)

手元では XAI_BASE_URL=http://127.0.0.1:18655/v1 にして模擬サーバーへ送りました。出力と、模擬サーバーが受け取った中身です(キーは途中で切っています)。

$ python3 c1_openai_responses.py
(模擬サーバーの固定の応答)
ResponseUsage(input_tokens=12, input_tokens_details=None, output_tokens=9, output_tokens_details=None, total_tokens=21)

[模擬サーバーの記録]
POST /v1/responses
authorization: Bearer xai-dum...(略)
content-type: application/json
user-agent: OpenAI/Python 3.55.0
x-stainless-retry-count: 0
body: {"model":"grok-4.7","input":[{"role":"user","content":"Grok API の要点を1文で"}],"max_output_tokens":200}

SDK が送るのは Authorization: Bearer キー と JSON の本文だけで、公式の curl の例と同じ形です。

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.7", "input": "Grok API の要点を1文で"}'

Responses API と Chat Completions の違い

Responses API(/v1/responses)

本文は input、上限は max_output_tokens

previous_response_id で前の会話を続けられる

応答はサーバーに30日保存(store の既定は true)

Chat Completions(/v1/chat/completions)

本文は messages、上限は max_tokens

状態を持たない。履歴を毎回送り直す

公式は legacy と説明。新機能は Responses API が先

OpenAI SDK の書き方そのものは、関連記事「OpenAI API Python入門|Responses APIのコピペ集」で詳しく扱っています。同じ OpenAI 互換の形をとる DeepSeek の API は、記事「DeepSeek APIの使い方|料金・APIキー・OpenAI互換のPython例」の題材です。

xAI SDK(xai_sdk)での呼び出し

この節では、公式の xAI SDK の書き方と、OpenAI SDK との送り方の違いが分かります。

xai_sdk は HTTP ではなく gRPC で api.x.ai に送ります。 会話を chat.create() で作り、append() で発言を足して、sample()(まとめて受け取る)か stream()(少しずつ受け取る)を呼ぶ形です。

import os
from xai_sdk import Client
from xai_sdk.chat import user, system

client = Client(api_key=os.environ["XAI_API_KEY"])   # 既定の接続先は api.x.ai
chat = client.chat.create(model="grok-4.7", max_tokens=200)
chat.append(system("短く答える"))
chat.append(user("Grok API の要点を1文で"))
r = chat.sample()
print(r.content, r.usage.prompt_tokens, r.usage.completion_tokens)

chat2 = client.chat.create(model="grok-4.7")
chat2.append(user("こんにちは"))
for response, chunk in chat2.stream():
    print(chunk.content, end="", flush=True)

手元では Client(api_host="127.0.0.1:18656", use_insecure_channel=True) にして、xai_sdk に同梱の定義で作った gRPC の模擬サーバーに送りました。

sample: (gRPC 模擬の応答) | usage: 15 8
gRPC|の|ストリーム|

[模擬サーバーの記録]
rpc: GetCompletion
metadata: user-agent: XaiSdk/1.21.0 grpc-python/1.85.3 ...
          authorization: Bearer xai-dum...(略)
          xai-sdk-version: python/1.21.0
request: {"messages": [{"content": [{"text": "短く答える"}], "role": "ROLE_SYSTEM"},
                       {"content": [{"text": "Grok API の要点を1文で"}], "role": "ROLE_USER"}],
          "model": "grok-4.7", "maxTokens": 200, "n": 1}
rpc: GetCompletionChunk   (stream() のとき)
  • キーが無いときの原文:ValueError: Trying to read the xAI API key from the XAI_API_KEY environment variable but it doesn't exist.
  • xai_sdk には OpenTelemetry のトレースの仕組みがあり、XAI_SDK_DISABLE_TRACING=1 で止められます(SDK のソースで確かめました)。

SDK の選び方

OpenAI SDKHTTP。既存の OpenAI 向けのコードを base_url だけ変えて流用できる。プロキシを通しやすい
↔
xai_sdkgRPC。Grok 独自の機能(検索ツール・費用の取得など)を型つきで扱える公式の SDK

迷ったら:既存のコードがあるなら OpenAI SDK、新しく作るなら公式の xai_sdk

Grok API のストリーミングの使い方

この節では、応答を少しずつ受け取る書き方と、流れてくるデータの形が分かります。

ストリーミングは、リクエストに "stream": true を付けると、Server-Sent Events(SSE)で差分が届き、最後に data: [DONE] が来ます。 OpenAI SDK での書き方です。公式の例は、推論するモデルで接続が途中で切れないよう、タイムアウトを3600秒と長めにしています。

client = OpenAI(api_key=os.environ["XAI_API_KEY"],
                base_url="https://api.x.ai/v1", timeout=3600)
stream = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "こんにちは"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

模擬サーバーに curl で送ったときの生のデータです(公式の例と同じ chat.completion.chunk の形をまねています)。

$ curl -N .../v1/chat/completions(stream: true を付けて送る)
data: {"id": "chat_mock_1", "object": "chat.completion.chunk", "created": 0, "model": "grok-4.7", "choices": [{"index": 0, "delta": {"content": "模擬", "role": "assistant"}}]}

(「の」「ストリーム」の2行が同じ形で続く)

data: [DONE]

SDK 経由では 模擬|の|ストリーム| の3回に分かれて届きました。画像を出力するモデルではストリーミングは使えません(公式)。

Grok API のエラーとレート制限(429の再試行)

この節では、HTTP ステータスごとの意味と直し方、レート制限の決まり、再試行の書き方が分かります。

公式のエラーのページは、ステータスごとの意味を次のように説明しています。 下の「手元」の欄は、模擬サーバーで同じ状況を作って SDK・curl で受けた結果です。

ステータス 公式の説明 直し方 手元(OpenAI SDK の例外など)
400本文の値の誤り・URL のパラメーターの誤り・正しくない API キー本文と URL を見直す―
401Authorization ヘッダーが無い・トークンが無効Authorization: Bearer <XAI_API_KEY> を付けるcurl で HTTP 401
403キーやチームに権限が無い・止められているチームの管理者に権限を頼む―
404モデル名が無い・URL の綴りの誤りモデル名と URL を API リファレンスで確かめるNotFoundError Error code: 404
405HTTP のメソッドの誤りGET と POST を確かめるcurl の GET で HTTP 405
415本文が空・JSON の Content-Type が無いContent-Type: application/json を付けるcurl で HTTP 415
422本文の項目の形式の誤り本文を API リファレンスで確かめる―
429リクエストが多すぎる頻度を下げる・上限を上げるRateLimitError(xai_sdk は RESOURCE_EXHAUSTED)

レート制限の決まり

  • 上限はモデルごとに、1秒あたりのリクエスト数(RPS)と1分あたりのトークン数(TPM)の2つです。RPS は1分あたりのリクエスト数(RPM)を48で割った値(最低2)です。たとえば RPM 480 なら RPS 10 になります。
  • 階層(Tier)は2026年1月1日からの累計の支払額で決まり、下がることはありません。
  • 自分の階層とモデルごとの上限は、コンソールの Models のページで見られます。
  1. 0Tier 0:$0(既定)登録した直後
  2. 1Tier 1:累計 $50 から支払いが増えると自動で上がる
  3. 2Tier 2:累計 $250 から―
  4. 3Tier 3:累計 $1,000 から―
  5. 4Tier 4:累計 $5,000 からさらに上は Enterprise(申し込み)

429 の再試行(手元で動かした結果)

OpenAI SDK は、429 を受けると既定で2回まで自動で再試行しました。 模擬サーバーが2回続けて429(retry-after: 1)を返すようにして送ると、3回目で成功し、経過は2.04秒でした。記録には再試行の回数が x-stainless-retry-count として残ります。

結果: (模擬の応答) 経過 2.04 秒
[模擬サーバーの記録]  経過(秒)  x-stainless-retry-count
                      0.0      0
                      1.0      1
                      2.01     2

自分で回数と待ち時間を決めたいときは、OpenAI(..., max_retries=0) にして RateLimitError を受け、待ち時間を倍にしながら再試行します(公式の例は最大5回、2 ** attempt 秒待つ形。1・2・4・8・16秒で合計31秒)。

手元で待ち時間を短くして動かすと、2回の429のあと3回目で200になりました。429 の考え方は、関連記事「LLM APIの429・529エラー対処|リトライ実装とエラー一覧」で詳しく扱っています。障害が疑われるときは公式の状態のページ(status.x.ai)を見ます。

Grok API のデータの扱いと地域(提供元の説明)

この節では、送った内容の保存期間や学習への利用について、提供元が何と説明しているかが分かります。

公式の「Data & Privacy」のページは、明示の許可なく API の入力・出力を学習に使わないと説明しています。 以下は提供元の説明の紹介で、RJC が内容を保証するものではありません。機密情報・個人情報を送る前に、提供元の最新の規約と所属先の決まりを確かめます。

  • 保存:既定では、API のリクエストと応答は監査のために30日間サーバーに暗号化して保存され、30日後に自動で消える。
  • ZDR(Zero Data Retention):有効にすると入力と出力をディスクに残さない。チーム全体の設定で、公式は多くの利用者には勧めないとしている。
  • 処理の地域:既定のエンドポイント(api.x.ai)は処理の地域を保証しない。US のエンドポイント(https://us.api.x.ai/v1)は、リクエストの処理・推論・保存を米国内にとどめる。ただし使えるのは grok-4.7・grok-4.6 だけで、ファイル・コレクション・サーバー側のツールは保証の外。

US のエンドポイントへの切り替えは、OpenAI SDK なら base_url="https://us.api.x.ai/v1"、xai_sdk なら api_host="us.api.x.ai"(https:// と /v1 を付けない)です。公式は、既存の API キーがどちらでも使えると書いています。

  • 1キーは環境変数か秘密の管理の仕組みに置くコード・リポジトリ・ログに残さない。漏れたらコンソールで無効化か再発行
  • 2キーごとに使えるモデルと上限を絞るACL と qpm・tpm で、1本のキーの使いすぎを止める
  • 3送るデータの種類を先に決める保存の30日・ZDR・地域の説明を読み、所属先の決まりと合わせる
  • 4自動の買い足しに月の上限を付けるAuto top-up は月の最大額を設定できる

よくあるエラー/つまずき

この節では、Grok API を使い始めたときにつまずきやすい点と、その直し方が分かります。

症状・原文 原因 直し方
Missing credentials. Please pass an `api_key`...(OpenAI SDK)api_key を渡していない。OpenAI SDK は XAI_API_KEY を自動では読まないapi_key=os.environ["XAI_API_KEY"] を渡す
Trying to read the xAI API key from the XAI_API_KEY environment variable but it doesn't exist.xai_sdk が環境変数を見つけられない同じシェル・同じ実行環境で XAI_API_KEY を設定する
401ヘッダーが無い・キーの誤りBearer の形と、キーの前後の空白を確かめる
404(モデル名)grok-4-7 のような綴りの誤りモデル名は grok-4.7(点で区切る)
以前の記事のコードで費用が増えたgrok-3 などは grok-4.3 に転送され、その単価で課金model を書き換え、推論の深さを指定する
リクエストが急に通らなくなった前払いのクレジットが無くなった残高を確かめ、必要なら Auto top-up を設定する
429 が続くRPS か TPM の上限。推論のトークンも数えられる待って再試行。Batch API にまとめる。階層を上げる
費用が予想の約2倍プロンプトが20万トークンを超え、全トークンが長文の単価入力を分けるか、文脈を減らす

Grok API を使うかの判断表

この節では、やりたいことごとに、Grok API のどの機能・どのモデルを選ぶかが分かります。

やりたいこと 選ぶもの 理由(公式の記載)
まず1回動かしたいgrok-4.7 + OpenAI SDK(Responses API)クイックスタートの例と同じ形
費用を下げたい・大量に流すgrok-4.3 や grok-4.20 系、Batch API単価が低い。Batch は20%引き
X の最新の話題をもとに答えさせたいResponses API + x_search投稿・プロフィールの件数で別料金
X に投稿したい・X のデータを集めたいX APIGrok API の役割ではない
処理を米国内にとどめたいUS のエンドポイントgrok-4.7・4.6 だけ。1.1倍
既存の OpenAI 向けのコードを使い回したいOpenAI SDK の base_url を変える公式が OpenAI SDK の例を載せている

関数を呼ばせる(Function Calling)仕組みは各社でほぼ共通です。考え方と実装は、関連記事「Function Calling(tool use)の仕組みとPython実装」で扱っています。ほかの提供元の API と並べて比べたいときは、関連記事「Claude API Python入門|Anthropic SDKコピペレシピ集」も同じ観点で読めます。

よくある質問

この節では、Grok API についてよく調べられる疑問への答えが分かります。

Q. Grok API は無料で使えますか?
トークン単位の従量課金で、前払いのクレジットから引かれます。2026年11月18日時点の公式の料金・請求のページには、無料のクレジットの記載は見つかりませんでした(プロモーションコードの入力欄の説明はあります)。

Q. X Premium(X の有料プラン)に入っていれば Grok API も使えますか?
公式のドキュメントでは、API はコンソール(console.x.ai)のチームにクレジットを入れて使い、その残高から引かれる仕組みとして説明されています。X の購読との関係は、公式ドキュメントの「X Subscription」の節で最新の説明を確かめるのが確実です。

Q. OpenAI のライブラリで Grok API を使えますか?
使えます。公式のクイックスタートに、OpenAI SDK の base_url を https://api.x.ai/v1 にする例があります。手元でも、送られる中身は Bearer のキーと JSON の本文だけでした。

Q. grok-3 や grok-4-0709 はまだ使えますか?
2026年5月15日に退役し、リクエストは grok-4.3 などに転送されます。転送先の単価で課金されるため、公式は model の書き換えを勧めています。

Q. 送った内容は学習に使われますか?
提供元は、明示の許可なく API の入力・出力を学習に使わない、既定では30日保存して自動で消す、と説明しています。送る前に最新の規約と所属先の決まりを確かめます。

Q. 429 Too Many Requests が出たら?
少し待ってから再試行します。OpenAI SDK は既定で2回まで自動で再試行しました。上限は累計の支払額で決まる階層で上がり、コンソールの Models のページで確かめられます。

Q. Chat Completions はもう使えないのですか?
公式では legacy のエンドポイントとして載っており、終了日は書かれていませんでした。新機能は Responses API に先に入ります。

Q. xai_sdk と OpenAI SDK のどちらを使うべきですか?
既存の OpenAI 向けのコードがあるなら OpenAI SDK、Grok の機能を型つきで使いたいなら公式の xai_sdk です。xai_sdk は gRPC で送るため、HTTP のプロキシしか通らない環境では OpenAI SDK が通しやすいことがあります。

まとめ

この節では、記事の要点を5つにまとめます。

  • Grok API は Grok のモデルをプログラムから呼ぶ有料の API。公式ドキュメントの提供元の表記は2026年11月18日時点で「SpaceXSI」、ドメインと SDK は x.ai・xai のまま。
  • 主力は grok-4.7(入力 $2.00・出力 $6.00、100万トークンあたり)。20万トークンを超えると全トークンが倍の単価。
  • キーは console.x.ai でクレジットを入れてから作り、XAI_API_KEY に置く。残高が無いとリクエストは断られる。
  • OpenAI SDK は base_url を変えるだけで呼べ、送る中身は Bearer のキーと JSON。xai_sdk は gRPC で送る。
  • 429 は待って再試行。データの扱い・地域は提供元の説明を読み、送るデータの種類を先に決める。

参考・出典

この節では、記事で確かめた公式の情報源が分かります(確認日 2026年11月18日)。

  • SpaceXSI Docs「Quickstart」:https://docs.x.ai/developers/quickstart
  • SpaceXSI Docs「Models」:https://docs.x.ai/developers/models
  • SpaceXSI Docs「Pricing」:https://docs.x.ai/developers/pricing
  • SpaceXSI Docs「Release Notes」:https://docs.x.ai/developers/release-notes
  • SpaceXSI Docs「Model Retirement (May 15, 2026)」:https://docs.x.ai/developers/migration/may-15-retirement
  • SpaceXSI Docs「Rate Limits」:https://docs.x.ai/developers/rate-limits
  • SpaceXSI Docs「Debugging Errors」:https://docs.x.ai/developers/debugging
  • SpaceXSI Docs「Streaming」:https://docs.x.ai/developers/model-capabilities/text/streaming
  • SpaceXSI Docs「X Search」:https://docs.x.ai/developers/tools/x-search
  • SpaceXSI Docs「Regional Endpoints」:https://docs.x.ai/developers/advanced-api-usage/regions
  • SpaceXSI Docs「Data & Privacy」:https://docs.x.ai/developers/faq/security
  • SpaceXSI Docs「Manage Billing」:https://docs.x.ai/console/billing
  • SpaceXSI Docs「Accounts and Authorization(Management API)」:https://docs.x.ai/developers/rest-api-reference/management/auth

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「Grok APIの使い方|xAIのAPIキー・料金・Pythonでの呼び出し」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり