エラー処理

H3 動画タスク API · /api/v3

エラーレスポンス

JSON · パラメータエラー例

{
  "error": {
    "code": "InvalidParameter",
    "message": "model、content、生成パラメータを確認してください",
    "request_id": "REQUEST_ID"
  }
}

HTTP ステータス、error.code、error.message およびリクエスト ID を保存してください。ゲートウェイやミドルウェアのエラーコードは異なる場合があるため、サンプル文字列だけで判定しないでください。

HTTP	意味	推奨対応
401	認証失敗	Bearer キーを確認してください。
402	利用予算の不足	管理者に利用予算の調整を依頼してください。発生済みの月次請求額を意味するものではありません。
403	アカウント・モデルの権限なし	アカウントの状態とモデル権限を確認してください。
404	タスクが存在しないか期限切れ	アカウント、ID、取得プロトコルを確認してください。
409	冪等性・状態の競合	同じキーでリクエスト内容を変更していないか、タスクがキャンセル不可の状態になっていないかを確認してください。
413	入力サイズ超過	画像またはリクエストのサイズを小さくしてください。
422	未対応のパラメータ・画像	データ型、画像形式、モデル仕様を確認してください。
429	頻度制限・キュー上限	Retry-After に従い、冪等キーを保持してください。
500 / 502 / 503	サービスエラー・容量不足	バックオフ後に再試行し、同じ作成リクエストには元の冪等キーを使用してください。

通信がタイムアウトしてもサーバー側のタスクはキャンセルされません。ID があればそのまま状態を確認し、作成時に ID を受け取れなかった場合は元の冪等キーで同じリクエストを再試行します。