エラー 400:gpt-4o-mini の呼び出しに失敗したときの対処
400 はリクエスト自体が不正であることを意味します。必須項目の欠落、型の誤り、またはこのモデルが対応していないパラメータです。再試行では解決せず、リクエスト本文を修正する必要があります。
400 Bad Request は、リクエスト本文自体が不正なためにサーバーが処理を拒否したことを意味します。5xx と異なり、400 は再試行しても解消しません。毎回同じ応答が返るため、まずパラメータを修正する必要があります。
gpt-4o-mini は OpenAI が提供しており、このページの誘因分析・対処法・実測データはすべてゲートウェイ層におけるこのモデルの実際の稼働実績に基づいています。
このゲートウェイで最も多い诱因は「必須フィールド(model または messages)が欠落している」です。まず取り組むべき対処は「このページのパラメータ表とリクエスト本文を照合する」です。
主な原因
- 必須フィールド(model または messages)が欠落している
- パラメータの型が誤っている
- このモデルが対応していないパラメータを使っている
- messages の構造が不正、または role の値が不正
対処方法
- このページのパラメータ表とリクエスト本文を照合する
- 未対応のパラメータを外して再試行する
- messages が配列で role が正しい値か確認する
- 最小のリクエストで通してから、パラメータを1つずつ追加する
指数バックオフによるリトライ例
以下のコードは、gpt-4o-mini が 400 を返したときに最大 5 回まで再試行します。待機時間は指数的に増加し、ランダムなジッタを加えることで同時再試行を防ぎます。base URL と API キーは環境変数から読み取り、コードに直接書かないでください。
import os, time, random
import requests
BASE = os.getenv("OPENAI_BASE_URL") # e.g. https://<your-gateway>/v1
KEY = os.getenv("OPENAI_API_KEY")
MODEL = 'gpt-4o-mini'
def chat(messages, retries=5):
"""Retry with exponential backoff + jitter."""
for i in range(retries):
try:
r = requests.post(
BASE + "/chat/completions",
headers={"Authorization": "Bearer " + KEY},
json={"model": MODEL, "messages": messages, "stream": True},
timeout=60,
)
if r.status_code == 429 or r.status_code >= 500:
time.sleep(min(2 ** i + random.uniform(0, 1), 30))
continue
r.raise_for_status()
return r.json()
except requests.exceptions.Timeout:
time.sleep(min(2 ** i + random.uniform(0, 1), 30))
raise RuntimeError("gave up after " + str(retries) + " retries")
print(chat([{"role": "user", "content": "hello"}]))このモデルの主要データ
| TPS | 260.87 |
|---|---|
| 平均レイテンシ | 1408 ミリ秒 |
| 成功率 | 100% |
| API エンドポイント | https://api.airai.cc/v1 |
| OpenAI 互換 | OpenAI-compatible |
| 提供元 | OpenAI |
|---|---|
| コンテキスト | 128K |
| 対応機能 | Tools, Files, Vision |
| API形式 | openai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search |
| 課金計算式 | p * 0.15 + cr * 0.075 + c * 0.6 |
よくある質問
gpt-4o-mini が 400 を返すとき、リクエストパラメータを変更すべきですか?
クライアント側の設定問題であり、サーバー側の変更は不要です。このモデルの能力タグは Tools, Files, Vision で、パラメータの上限はその能力セットに従います。パラメータ起因のエラーはすぐ失敗させ、再試行を無駄にしないでください。長い入力は先に切り詰めるか要約すると、400 の発生率を大きく下げられます。
テスト環境は問題ないのに本番で 400 が出るのはなぜですか?
エラーを時間とノードで集計してから見ると、傾向はたいてい明確です。本番だけで起きるなら、たいていはモデルではなく環境の違いです。このモデルは OpenAI が提供しており、upstream の状態は提供元の告知に準じます。失敗のたびにリクエスト ID を記録してください。ステータスコードより有用です。
1 つのキーを複数サービスで共有すると 400 は発生しやすくなりますか?
プラン上限を上げるか、呼び出し頻度を下げるかのどちらでも緩和できます。p * 0.15 + cr * 0.075 + c * 0.6 の課金では、長い出力のコストは主に出力トークンから生じます。p * 0.15 + cr * 0.075 + c * 0.6 でコストを見積もる際は、再試行の分も予算に含めてください。
レスポンスの Retry-After ヘッダーはどう使えばよいですか?
通常ビジネスロジックを変更する必要はなく、呼び出し間隔の調整で十分です。再試行が最も効果的な最初の一歩です。実測成功率は 100% です。そのため初回の再試行が最も効果的です。再試行の上限は 3〜5 回に設定し、ジッターを加えてください。再試行可能なエラーには指数バックオフを使い、それ以外は即座にエラーを返してください。
このモデルの他のエラー
- gpt-4o-mini: エラー 429 の原因と対処法
- gpt-4o-mini: エラー timeout の原因と対処法
- gpt-4o-mini: エラー 500 の原因と対処法
- gpt-4o-mini: エラー 502 の原因と対処法
- gpt-4o-mini: エラー 503 の原因と対処法
- gpt-4o-mini: エラー 504 の原因と対処法
- gpt-4o-mini: エラー 401 の原因と対処法
- gpt-4o-mini: エラー 403 の原因と対処法
同じエラーが出る他のモデル
- gpt-5
- claude-opus-5
- gemini-2.5-pro
- deepseek-v4-pro
- grok-4.3
- llama-3.3-70b-instruct
- qvq-max
- qwq-32b
- glm-5
- MiniMax-M3
- kimi-k3
- hy3
- doubao-seed-evolving
- mimo-v2.5
- gpt-4o
- claude-opus-4-6
データ更新: 2026-10-10 15:45