Admesh/ドキュメントはじめに

エラーコード

Updated 2026/9/19

リクエストが失敗した場合、統一されたエラー構造が返されます。codeフィールドは、機械可読なコードです。

エラーコード一覧

HTTP コード 課金 説明
400 invalid_request いいえ 無効なリクエストパラメータ
401 invalid_api_key いいえ API キーの欠落または無効
402 insufficient_balance いいえ 残高不足 — チャージしてください
403 model_not_allowed いいえ このキーではモデルへのアクセスが許可されていません
429 rate_limit_exceeded いいえ レート制限 — 後で再試行してください
500 billing_settlement_error 非同期照合 課金精算の失敗
502 upstream_error 通常はなし 上流サービスのエラー
503 model_provider_unavailable なし モデルサービスが一時的に利用不可
504 upstream_timeout 通常は「いいえ」 アップストリームのタイムアウト

トラブルシューティング

  1. 401: Authorization: Bearer の値が完全な sk-live-* シークレットであり、キーが失効していないことを確認してください。
  2. 402: コンソールで残高を補充してください。
  3. 429: 同時実行数を減らすか、retry-afterが解決するまで待ってから再試行してください。
  4. 5xx: しばらくしてから再試行してください。それでも問題が解決しない場合は、request_idを添えてサポートに連絡してください。

エラー例

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}