Aiberm logo
ログイン

エラーハンドリング

Aiberm API リクエストが失敗すると、API は JSON のエラーオブジェクトを返します。HTTP ステータスコード、error.code、error.message を使って問題を特定し、次の対応を判断してください。

サポートが必要な場合は、すべての request id を含む完全なエラーレスポンスを添えてください。

エラーレスポンス形式

{
  "error": {
    "message": "用户额度不足, 剩余额度: ¥0.00 (request id: 20260622xxxxxxxx)",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}
フィールド意味
message人が読めるエラーメッセージです。末尾の (request id: ...) はこのリクエストのトレース ID です。サポートに連絡する際は含めてください。
codeエラー種別の識別子です。下記のよくあるエラーと照合してください。
typeエラー発生源のマーカーです。ほとんどの場合、直接扱う必要はありません。

message に複数の (request id: ...) が含まれる場合もあります。これは正常で、リクエストが複数のサービス層を通過したことを意味します。サポートに連絡する際は、エラーメッセージ全文をコピーしてください。

HTTP ステータスコード

ステータス意味対処
400リクエスト形式が無効ですリクエスト JSON、必須フィールド、Content-Type、モデル名を確認してください。
401API キーが無効ですAPI キーが正しいか、期限切れ・無効化・残高不足でないかを確認してください。
403権限がない、または残高不足ですアカウント残高、トークン権限、モデル権限、送信元 IP を確認してください。
404リソースが見つかりませんエンドポイント URL とモデル名のスペルを確認してください。
429リクエストが多すぎます同時実行数またはリクエスト頻度を下げてから、後で再試行してください。
500内部サーバーエラーです後で再試行してください。続く場合は request id を添えてサポートに連絡してください。
503一時的にサービスを利用できませんそのモデルに現在利用可能なルートがありません。後で再試行するか、サポートに連絡してください。

API キーと認証エラー

これらのエラーは通常 401 を返します。

表示される可能性のあるメッセージよくある原因対処法
无效的令牌API キーが正しくないか、存在しません。キーが完全で、余分な文字や欠けがないことを確認し、コンソールから再度コピーしてください。
该令牌已过期トークンの有効期限が切れています。コンソールでトークンを再発行するか、有効期限を延長してください。
该令牌额度已用尽このトークンに割り当てられたクォータを使い切りました。トークンのクォータを増やすか、十分なクォータがある別のトークンを使ってください。
该令牌状态不可用トークンが無効化されています。コンソールでトークンを有効にするか、新しいトークンを作成してください。
未提供令牌リクエストに API キーが含まれていません。リクエストヘッダーに Authorization: Bearer sk-xxxxxx を追加してください。

権限と残高のエラー

これらのエラーは通常 403 を返します。

表示される可能性のあるメッセージよくある原因対処法
用户额度不足, 剩余额度: ...このリクエストに対してアカウント残高が不足しています。アカウントにチャージして再試行してください。
预扣费额度失败, 用户剩余额度: ...見積もりリクエスト費用をカバーできる残高がありません。チャージするか、max_tokens を減らし、入力を短くしてください。
您的 IP 不在令牌允许访问的列表中トークンに IP 許可リストがあり、現在の IP は許可されていません。許可された IP を使うか、コンソールで許可リストを更新してください。
用户已被封禁アカウントが停止されています。詳細はサポートに連絡してください。
无权访问 xxx 分组トークンはリクエストされたグループにアクセスできません。許可されたグループを使うか、アクセスを申請してください。
该令牌无权访问模型 xxxトークンの許可モデル一覧にこのモデルが含まれていません。許可されたモデルを使うか、コンソールでトークンのモデル権限を更新してください。

リクエスト内容のエラー

これらのエラーは通常 400 を返します。

表示される可能性のあるメッセージよくある原因対処法
Invalid request, ...リクエストボディを解析できません。JSON が有効で、Content-Type が application/json であることを確認してください。
未指定模型名称，模型名称不能为空リクエストに model フィールドがありません。リクエストボディに正しい model を追加してください。
检测到敏感词 のようなメッセージ入力がコンテンツセーフティのルールに一致しました。入力を調整して再試行してください。

レート制限エラー

これらのエラーは通常 429 を返します。

表示される可能性のあるメッセージよくある原因対処法
您已达到请求数限制：N分钟内最多请求M次成功リクエストの上限に達しました。リクエスト頻度を下げ、制限ウィンドウがリセットされたあとに再試行してください。
您已达到总请求数限制：...，包括失败次数...失敗リクエストを含む総リクエスト上限に達しました。失敗リクエストのループが起きていないか確認し、原因を直してから再試行してください。

モデルとルートのエラー

これらのエラーは通常 404 または 503 を返します。

表示される可能性のあるメッセージよくある原因対処法
模型不存在モデル名のスペルが違うか、このモデルがトークンで有効になっていません。モデル名とトークンのモデル権限を確認してください。
无可用渠道そのモデルに現在利用可能なルートがありません。後で再試行してください。利用できない状態が続く場合はサポートに連絡してください。

サーバーエラー

これらのエラーは通常 500 または 503 を返します。

表示される可能性のあるメッセージよくある原因対処法
内部エラーメッセージ一時的なサーバー問題、または上流サービスが一時的に利用できません。後で再試行してください。続く場合は request id を添えてサポートに連絡してください。

サポートに連絡する前に

問題をより早く特定できるよう、次を提供してください。

  1. message、code、すべての request id を含む完全なエラーレスポンス
  2. 問題が発生したおおよその時刻
  3. 呼び出したモデル名とエンドポイント URL
  4. API キーの先頭数文字（例: sk-abcd...）。キー全体は送らないでください。
GitHub でこのページを編集