エラーコード一覧

HTTP ステータスコード

ステータスコード	意味	対処方法
200	リクエスト成功	—
400	リクエストパラメータエラー	JSON フォーマットおよび必須パラメータの有無を確認してください
401	認証失敗	API キーが正しいか、有効期限切れや無効化されていないか確認してください
403	権限不足	このキーが対象モデルへのアクセスを許可されていない可能性があります
429	レートリミット超過	リクエスト頻度を下げるか、サポートに RPM 枠の引き上げをご相談ください
500	サーバーエラー	リクエストを再試行してください。継続する場合はサポートチケットを送信してください
502/503	上流モデルサービスの異常	しばらくしてから再試行してください。別のモデルへの切り替えも可能です

{
  "error": {
    "message": "Invalid API key provided: sk-nex-xxx...xxx.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Invalid API key provided

原因： API キーが正しくないか、削除されています。

解決方法： コンソールでキーのステータスを確認し、完全なキーを再度コピーしてください。

Model 'xxx' not found

原因： モデル ID のスペルミス、またはそのモデルがお客様のプランで有効化されていません。

解決方法： モデル ID が正しいか確認してください（大文字・小文字を区別します）。/v1/models エンドポイントで完全なモデル一覧を取得できます。

Rate limit exceeded

原因： リクエスト頻度が RPM（1分あたりのリクエスト数）の上限を超えました。

解決方法： リクエスト頻度を下げ、リクエスト間隔を広げてください。より高い上限が必要な場合はサポートにご連絡ください。

This model's maximum context length is xxx tokens

原因： 入力と出力の合計トークン数がモデルの上限を超えました。

解決方法： 入力内容の長さを減らすか、max_tokens パラメータの値を下げてください。

429 および 5xx エラーには、エクスポネンシャルバックオフによるリトライを推奨します：