Grok APIの401・403・404・400を切り分ける｜Windowsでの確認順

Grok APIが動かないときは、最初にHTTPステータスと返ってきたエラーの説明を見ます。401なら認証、403なら権限、404ならURLや対象リソース、400なら送信内容が主な確認先です。同じ「動かない」でも、APIキーの作り直しが必要とは限りません。

この記事は2026年9月5日に確認した公式資料をもとにした診断手順です。下のリクエストは構成例で、有料APIでの実行結果を掲載した実験ログではありません。

エラー番号から、変更する場所を絞る

応答	先に調べること	まだ変更しないこと
401	実行中アプリが正しいキーを読めるか。認証ヘッダーの付け忘れがないか	プロンプトや出力形式
403	キー・アカウントに対象操作の権限があるか。応答本文の説明	Windowsの実行ポリシー
404	ホスト名、APIのパス、モデルやファイルなど指定先の綴り	根拠のないモデル名への置換
400	JSON構文と、そのエンドポイントが受け付ける項目	OS全体や依存ライブラリの一括更新

この対応表は原因を断定するものではありません。たとえば404だけでは「モデルが廃止された」とは判断できません。xAIの2026年5月15日の移行案内には、対象の旧モデル名へのリクエストを別モデルへ振り向ける仕様もあります。エラー本文の対象名まで読んでください。

Windowsから送るJSONを最小にする

添付ファイル、検索、複数ターン、ストリーミングを一度に試すと、失敗した項目が分かりません。まず公式Quickstartと同じResponses APIの形で、短いテキストだけを送ります。次の例は、APIキーを既に安全な方法で環境変数へ設定してあるPowerShell向けです。実行するとAPI利用料が発生し得ます。

if ([string]::IsNullOrWhiteSpace($env:XAI_API_KEY)) {
  throw 'XAI_API_KEY is missing in this process'
}
$request = @{ model = 'grok-4.6'; input = 'Reply with OK.' }
$json = $request | ConvertTo-Json -Depth 5
$params = @{
  Uri = 'https://api.x.ai/v1/responses'
  Method = 'Post'
  Headers = @{ Authorization = ('Bearer ' + $env:XAI_API_KEY) }
  ContentType = 'application/json'
  Body = $json
  TimeoutSec = 60
}
$result = Invoke-RestMethod @params
$result.id

モデル名は確認時点の公式例に合わせています。利用時は最新のモデル一覧と自身の利用権限を確認してください。キーの値や認証ヘッダーを画面に出す必要はありません。応答IDが得られれば、この最小構成では応答を受け取れたと判断できます。元の業務処理まで成功したことにはなりません。

最小構成が成功した後に戻す順番

1. 業務用の指示文だけに置き換え、応答を確認します。
2. 必要な入力データを、小さな説明用サンプルから追加します。
3. ファイルや外部ツールを一種類ずつ戻します。
4. 最後に、同時実行やストリーミングなどアプリ側の処理を戻します。

たとえば短い文章では成功し、PDFを戻したところで400になるなら、PDFの受け渡し方と、そのAPIでの指定方法を確認します。認証の再設定へ戻るより、直前の変更に集中できます。業務の自動実行はいったん止め、検証用の一件で確かめてから再開します。

問い合わせに添える情報を整理する

サポートや担当者へは、発生日時、呼び出したAPIパス、モデル名、HTTPコード、伏せ字にしたエラー文、最小構成で再現したかを伝えます。エラー全文には入力データが混ざる場合があるため、送る前にAPIキー・個人情報・顧客情報を除いてください。

Windows側の変数が怪しいときは環境変数を値を出さずに調べる方法、廃止前後で挙動が変わったときはGrokのモデル移行チェック表が次の確認先です。社内の復旧担当が決まっていない場合は、AI業務の運用設計について相談することもできます。

参照した資料

• xAI：エラーの確認
• xAI：Quickstart
• xAI：モデル移行案内