エラーとステータスコード
EasyJev が返す全ステータスコード:request_id 付きの統一エラー JSON 構造、完全なコード表(400/401/402/403/404/413/422/429/502)、リトライ指針と上流パススルーのセマンティクス。
統一エラー構造
ゲートウェイ由来の失敗(認証、残高、レート制限、上流枯渇……)は /v1/* パスでこの JSON エンベロープを返します。例外は上流の検証エラーで、無変更でパススルーされます(systemone ページ参照)。
{
"error": {
"message": "Balance is not enough to make this call",
"type": "insufficient_quota",
"code": "insufficient_quota"
},
"request_id": "8f14e45fceea167a5a36dedd4bea2543"
}ステータスコード表
| HTTP | type | code | 意味 / 対応 |
|---|---|---|---|
| 400 | invalid_request_error | 上流パススルー | 上流がリクエスト本体を拒否。上流のメッセージに従って対応。課金されません。 |
| 401 | authentication_error | invalid_api_key | Bearer キー不足/誤り。sk- 値を確認。無効化されたキーもここに該当。 |
| 402 | insufficient_quota | insufficient_quota | 残高 0/マイナス。チャージ後に再試行。 |
| 403 | authentication_error | account_suspended / key_disabled | アカウントまたはキーが無効化——サポートに連絡。 |
| 404 | invalid_request_error | model_not_found | モデルが販売対象外(または誤字)。GET /v1/models で有効名を確認。 |
| 413 | invalid_request_error | payload_too_large / media_too_large | サイズ制限超過——本体を縮小かアセットを分割。 |
| 422 | invalid_request_error | bad_request(ゲートウェイ)/ 上流パススルー | model/state/questions 不足、または上流スキーマ拒否。 |
| 429 | rate_limit_error | rate_limit_exceeded | キー単位 RPM/TPM 超過。バックオフして再試行(制限窓は 1 分以内にローリングリセット)。 |
| 502 | api_error | upstream_failed | フェイルオーバー後も全「チャネル+キー」試行が失敗。バックオフ再試行可。継続時は request_id を添えてサポートへ。 |
リトライ指針
RETRY
安全に再試行できるのは 429(バックオフ後——スライディングウィンドウは 1 分以内に容量を解放)と 502(フェイルオーバー枯渇、上流の一時的障害はよくある)。400/401/402/403/404/413/422 は無闇に再試行しない——まずリクエスト自体を修正。再試行ごとに新しい request_id が付くため、照合は乱れません。