エラー

エラーの読み方

HTTP ステータスは API へのリクエストについての情報であり、error.code は失敗の理由を表します。両者は別のフィールドです: HTTP 200 はビジネスエラーコードではありません。

• 拒否された送信は、HTTP エラーステータスと error オブジェクトを返します。
• 成功したタスク照会は HTTP 200 を返します。生成が processing、completed、failed のいずれであるかは status で判断してください。
• 失敗したタスクでは、message の文言ではなく error.code で分岐してください。失敗理由が異なればコードも異なり、同じ理由にはモデルをまたいで同じコードが使われます。
• より具体的な公開可能な原因を特定できない場合は 60002 にフォールバックします。今後追加される未知のコードは、一般的な失敗として処理してください。

以下の表のエラーコードとメッセージは API がそのまま返す文字列のため、英語のまま記載しています。クライアントが実際に受け取る error.message と一字一句同じです。

Request errors

These HTTP statuses describe a rejected or unconfirmed submission, or a failed task query. A submission timeout does not prove that no task was created.

Task failures

A successful task query returns HTTP 200 even when generation failed. Check status: "failed" and error.code in the response. These codes describe the task outcome, not the HTTP request. Failed tasks are not charged.

{
  "id": "task_...",
  "status": "failed",
  "error": {
    "code": 60002,
    "message": "Generation could not be completed. Please try again."
  }
}

送信自体がタイムアウトした場合は、再送信の前にタスク履歴を確認してください。最初のリクエストが受理されている可能性があります。