エラー
ゲートウェイは OpenAI 互換のエラーエンベロープを返し、DeepToken 固有のカテゴリヘッダーを含むため、クライアントは文字列をパースせずにリトライ動作を分岐できます。
エンベロープ
{
"error": {
"message": "human-readable description",
"type": "category_name",
"code": "specific_code"
}
}
すべてのレスポンスには X-Gateway-Error-Category ヘッダーも含まれます。カテゴリは以下のいずれかです：
| カテゴリ | 意味 | リトライ？ |
|---|---|---|
platform_error | DeepToken 側の障害 | はい、バックオフ付き |
upstream_error | 上流プロバイダーの 5xx / タイムアウト | 既にリトライ済み；リトライしない |
quota_error | ウォレット / キーごとの予算が空 | いいえ — チャージしてください |
user_error | 不正なリクエスト / 不明なモデル / 許可されていないモデル | いいえ — リクエストを修正 |
一般的なコード
401 invalid_api_key— キーが無効化されたか存在しない403 model_not_allowed— キーの許可リストがモデルを禁止403 ip_not_allowed— リクエスト IP がキーの許可リストにない402 org_wallet_empty— 厳格モードの組織ウォレットの残高がゼロ403 budget_limit_exceeded— ローリングのキーごとの USD 上限を超過503 no_available_channel— このモデルを提供する稼働中のチャネルがない
リトライすべき場合
5xx platform_error エラーと、指定されたウィンドウが経過した後の 403 budget_limit_exceeded のみリトライしてください。その他はすべてリクエストから決定論的に決まるため、原因を修正せずにリトライしてもクレジットを無駄にするだけです。