API ドキュメントAPI ドキュメント
エラー
安定したエラーエンベロープ、コード、HTTP ステータス
エラーは固定のエンベロープで返され、非公開の診断情報を含むことはありません：
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid.",
"request_id": "req_012345"
}
}| HTTP | コード | 意味 |
|---|---|---|
| 400 | INVALID_REQUEST | ボディ・フォーム項目・ヘッダー・画像が不正 |
| 400 | CONTENT_POLICY_VIOLATION | このリクエストは処理できない |
| 401 | UNAUTHORIZED | API キーが未指定または不正 |
| 402 | INSUFFICIENT_CREDITS | 利用可能な残高が不足 |
| 403 | FORBIDDEN | 必要なスコープまたはベータアクセスがない |
| 404 | JOB_NOT_FOUND | ジョブが存在しないか、別アカウントのもの |
| 409 | IDEMPOTENCY_CONFLICT | 同じキーが異なる内容で再利用された |
| 409 | JOB_CANCELED | ジョブがキャンセルされた |
| 429 | RATE_LIMIT_EXCEEDED | リクエスト上限を超えた |
| 500 | JOB_FAILED | 画像ジョブを完了できなかった |
| 500 | INTERNAL_ERROR | リクエストを完了できなかった |
アップロードサイズ超過は HTTP 413 と INVALID_REQUEST で返ります。429 と
終了していないジョブは、記載された待機時間に従って再試行可能とみなしてください。
それ以外のエラーではリクエストを修正するか、request_id を添えてサポートに
連絡してください。人間向けのメッセージをプログラムの分岐条件に使わないで
ください。