エラー

API が返すすべてのエラーコードと、その意味・次の対応。

エラー形式

エラーボディの形式： { "code": "…", "error": "…" }. メッセージではなく code で分岐してください。再試行は結果が判明している場合のみ行い、ネットワークの結果が不確かな場合は Idempotency-Key を維持してください。レスポンスには、サポートへの問い合わせ時に伝える x-request-id ヘッダーが含まれます。

エラーコード

HTTP	コード	意味と対応
`401`	`AUTH_REQUIRED`	API キーまたはセッションがない、または無効です。
`403`	`INSUFFICIENT_SCOPE`	API キーにこのエンドポイントで必要な権限がありません。
`403`	`PERMISSION_DENIED`	この認証情報ではこの操作を実行できません。
`429`	`API_KEY_RATE_LIMITED`	API キーのレート制限に達しました。Retry-After に従ってください。
`429`	`API_KEY_USAGE_EXCEEDED`	API キーが使用上限に達しました。新しいキーを作成してください。
`400`	`INVALID_REQUEST`	ボディが JSON オブジェクトではないか、必須の値がありません。
`400`	`INVALID_IDEMPOTENCY_KEY`	Idempotency-Key は 1〜128 文字の印字可能な ASCII 文字である必要があります。
`400`	`INVALID_MODEL_INPUT`	input がモデルのスキーマと一致しません（不明なフィールド、必須フィールドの欠落、または無効な値）。
`400 / 413`	`INPUT_TOO_LARGE`	リクエストボディが 256 KB を超えています。先にメディアをアップロードし、メディア参照を送信してください。
`404`	`REQUEST_NOT_FOUND`	No chat request with this ID belongs to your account.
`404`	`MODEL_NOT_FOUND`	この slug のモデルはありません。
`404`	`JOB_NOT_FOUND`	この ID のタスクはお客様のアカウントに存在しません。
`409`	`IDEMPOTENCY_CONFLICT`	この Idempotency-Key は別の入力で使用されています。新しいリクエストには新しいキーを使ってください。
`409`	`PRICE_CHANGED`	料金が expectedPriceMicros と異なります。料金を取得して再度確認してください。
`409`	`MODEL_PRICE_UNAVAILABLE`	このモデルにはまだ料金が設定されていないため、実行できません。
`409`	`PAYMENT_REVIEW_REQUIRED`	A refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
`409`	`INSUFFICIENT_CREDITS`	利用可能なクレジットがタスクの料金に足りません。
`429`	`RATE_LIMITED`	1 分あたりのタスク送信数が多すぎます。後で再試行してください。
`429`	`CONCURRENCY_LIMITED`	未完了のタスクが多すぎます。いずれかが完了するまでお待ちください。
`503`	`EXECUTION_UNAVAILABLE`	現在、このモデルの実行は設定されていません。
`429`	`UPSTREAM_RATE_LIMITED`	The model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
`502`	`UPSTREAM_ERROR`	The model provider failed the chat request. Nothing was charged; retry later.
`503`	`PLATFORM_BUDGET_EXCEEDED`	This model is temporarily unavailable. Try again later.
`503`	`EXECUTION_TEMPORARILY_UNAVAILABLE`	一時的に実行できません。同じ Idempotency-Key で再試行してください。
`503`	`AUTH_UNAVAILABLE`	一時的に認証を利用できません。後で再試行してください。
`503`	`API_UNAVAILABLE`	一時的に API を利用できません。後で再試行してください。