Skip to content
EASYJEV

エラーとステータスコード

EasyJev が返す全ステータスコード:request_id 付きの統一エラー JSON 構造、完全なコード表(400/401/402/403/404/413/422/429/502)、リトライ指針と上流パススルーのセマンティクス。

統一エラー構造

ゲートウェイ由来の失敗(認証、残高、レート制限、上流枯渇……)は /v1/* パスでこの JSON エンベロープを返します。例外は上流の検証エラーで、無変更でパススルーされます(systemone ページ参照)。

JSON · error envelope
{
  "error": {
    "message": "Balance is not enough to make this call",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  },
  "request_id": "8f14e45fceea167a5a36dedd4bea2543"
}

ステータスコード表

HTTPtypecode意味 / 対応
400invalid_request_error上流パススルー上流がリクエスト本体を拒否。上流のメッセージに従って対応。課金されません。
401authentication_errorinvalid_api_keyBearer キー不足/誤り。sk- 値を確認。無効化されたキーもここに該当。
402insufficient_quotainsufficient_quota残高 0/マイナス。チャージ後に再試行。
403authentication_erroraccount_suspended / key_disabledアカウントまたはキーが無効化——サポートに連絡。
404invalid_request_errormodel_not_foundモデルが販売対象外(または誤字)。GET /v1/models で有効名を確認。
413invalid_request_errorpayload_too_large / media_too_largeサイズ制限超過——本体を縮小かアセットを分割。
422invalid_request_errorbad_request(ゲートウェイ)/ 上流パススルーmodel/state/questions 不足、または上流スキーマ拒否。
429rate_limit_errorrate_limit_exceededキー単位 RPM/TPM 超過。バックオフして再試行(制限窓は 1 分以内にローリングリセット)。
502api_errorupstream_failedフェイルオーバー後も全「チャネル+キー」試行が失敗。バックオフ再試行可。継続時は request_id を添えてサポートへ。

リトライ指針

RETRY

安全に再試行できるのは 429(バックオフ後——スライディングウィンドウは 1 分以内に容量を解放)と 502(フェイルオーバー枯渇、上流の一時的障害はよくある)。400/401/402/403/404/413/422 は無闇に再試行しない——まずリクエスト自体を修正。再試行ごとに新しい request_id が付くため、照合は乱れません。