🎉 各パックの初回購入で無料生成ギフト — 最大 Lite 動画 20 本 + Lite 画像 20 枚 + Medium 動画 10 本 + Pro 画像 10 枚 + Pro 動画 2 本。

今すぐ始める
DreamUtopia
ja

エラーと制限

すべての失敗は1つのエンベロープを使用します。コードは安定しており、メッセージはユーザーに表示できる英語のフォールバックです。

応答
{
  "error": {
    "code": "insufficient_credits",
    "message": "You need more credits to generate."
  }
}

ステータス

  • 400

    典型的なコード
    invalid_request, prompt_too_long, invalid_reference_image
    何をすべきか
    リクエストを修正してください。変更せずに再試行しないでください
  • 401

    典型的なコード
    unauthorized
    何をすべきか
    キーを確認してください。ループで再試行しないでください
  • 402

    典型的なコード
    insufficient_credits
    何をすべきか
    クレジットをチャージする。再試行しない
  • 403

    典型的なコード
    unauthorized
    何をすべきか
    未払いのキー作成、またはプレミアムなしでリクエストされた音声
  • 404

    典型的なコード
    not_found
    何をすべきか
    不明なジョブ、またはこのアカウントのものではありません
  • 409

    典型的なコード
    invalid_request
    何をすべきか
    Idempotency-Key が競合しています。新しいキーを使用してください
  • 413 / 415

    典型的なコード
    invalid_request / unsupported_image_type
    何をすべきか
    より小さいJPEG、PNG、またはWebPをアップロードしてください
  • 429

    典型的なコード
    rate_limited
    何をすべきか
    Retry-After を待ってください
  • 500 / 503

    典型的なコード
    internal
    何をすべきか
    バックオフして再試行

失敗した生成は、status: "failed" とコード internal の error オブジェクトを含む 200 のジョブレスポンスです。完了したジョブは終端です。再送信しないでください。

リトライポリシー

  • HTTP 429、timeout、internal の応答のみを再試行します。
  • insufficient_credits を再試行しないでください。また、すでに failed で終了したジョブを再送信しないでください。
  • 作成時に Idempotency-Key を使用して、リトライで二重に課金されないようにします。
  • 指数関数的にバックオフし、ジッターを加え、約1秒から開始する。

レート制限

制限はキーごと、特記なき限り固定の1分間ウィンドウです。デフォルト:

  • 全体で毎分60リクエスト。
  • 1分あたり10世代を生成。
  • 1分間に5回のアップロード。
  • 120 GET /v1/models リクエスト/分 クライアントIPごと(このルートは公開です)。
  • アカウントあたり1時間に5回のAPIキー作成。

429 には X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、Retry-After が含まれます。

可用性

/v1 が一時的に利用できない場合、すべてのルートはコード internal とともに 503 を返します。時間をおいてバックオフしながら再試行してください。

© 2026 DreamUtopia. 全著作権所有。