Error Code 400
Description: リクエストパラメータが無効です。Solution:
エラーメッセージの詳細を確認し、パラメータ形式、フィールド名、または値の範囲が API ドキュメントに準拠しているか確認してください。
Error Code 401
Description: API Key が見つからない、または正しくありません。Common causes:
- キーがない:
Authorizationヘッダーがない、またはヘッダーがAuthorization: Bearer <API Key>の形式になっていません。 - キーが間違っている、または形式が不正: タイプミス、余分な空白、または有効な
sk_キーではない値です。 - 削除されたキー: キーが Key Management で削除されたため、認証に使用できなくなっています。
- API Key がリクエストに含まれており、
Bearerスキームを使用していることを確認してください。 - API Key が正しく、Key Management にまだ存在することを確認してください。
- 環境変数または config ファイルを使用している場合は、実行時に正しく読み込まれていることを確認してください。キーの保存と読み込み方法については、API Keys を参照してください。
Error Code 403
Description: 権限不足によりアクセスが拒否されました。モデルへのアクセスが拒否されました (model_access_denied)
API key は有効ですが、リクエストされたモデルの呼び出しが許可されていません。キーの model access が制限されており、リクエストされたモデルがその範囲外です。
Solution:
- キーのアクセス範囲内にあるモデルを呼び出す、または
- チーム管理者に、対象モデルを含めるようキーの model access を調整してもらってください。
モデルには本人確認が必要です
一部のモデルは、アカウントがアクセスする前に本人確認を必要とします。 Solution:- API Key に関連付けられたアカウントに、リクエストされたモデルへアクセスする権限があることを確認してください。
- コンソールにログインし、アカウントの確認ステータスを確認してください。
- 未確認の場合は、まず本人確認を完了してください。
- 代わりに、すでに確認済みのアカウントの API Key を使用してください。
Error Code 429
Description: レート制限を超過しました（Too Many Requests）。Solution:
- 制限が TPM（tokens per minute）によるものか、RPM（requests per minute）によるものかを確認してください。
- 公式の Rate Limits ドキュメントを参照してください。
- レート制限を引き上げるには、サポートに連絡するか、確認済みアカウントを使用してください。
Error Code 503 / 504
Description: バックエンドのタイムアウト、またはサービス利用不可です。多くの場合、システム負荷の増大やスロットリングが原因です。考えられる原因:
- モデルサービスノード上の GPU または CPU の過負荷。
- 非ストリーミングリクエストでの長い生成時間がゲートウェイタイムアウトを超過。
- ダウンストリームサービス（例: Redis、model engine）の障害。
- トラフィックシェーピングモジュールがサージ保護を有効化し、503 を返した。
推奨される解決策:
API ユーザー向け:- リトライ機構を有効化: 繰り返し過負荷が発生するのを防ぐため、指数バックオフを使用してください。
- ストリーミングモードに切り替え: ストリーミングレスポンスは生成されるたびにトークンを返すため、レイテンシとタイムアウトのリスクを低減します。
- クライアント設定を最適化:
client_timeoutとproxy_timeoutが 60 秒を超えていることを確認してください。 - ピーク時間帯を避ける: 高同時実行シナリオでは、オフピーク時間帯に再試行してください。
- モデルサービスの監視とオートスケーリングを強化してください。
- ゲートウェイレベルの
proxy_read_timeoutを適切に調整してください。 - きめ細かなスロットリングルール（例: 優先度キュー、コアビジネス優先）を実装してください。
- Prometheus + Alertmanager を使用して、503/504 の急増時にアラートをトリガーしてください。
Error Code 500
Description: 内部サーバーエラーです。通常、バックエンド例外または model engine のクラッシュが原因です。Solution:
- これらの問題は通常、プラットフォーム側での解決が必要です。ログとシステムリソースを調査するため、サポートに連絡してください。
- 必要に応じて、モデルを切り替えるか、よりリソース消費の少ない設定にフォールバックしてみてください。
Other Errors
未定義またはドキュメント化されていないエラーの場合:- まず、API レスポンス内の
messageフィールドを参照してください。 - 次に、リクエストログまたはコンソールのトレースを確認してください。
- 最後に、Novita サポートへ連絡するか、チケットを送信して追加の支援を受けてください。