Seedance 2.5 API
エラーと再試行
エラー、再試行、共有上限と重複課金の防止。
エラーの形式
{
"error": {
"code": "invalid_parameters",
"message": "Unsupported resolution."
}
}エラーは application/json と HTTP ステータスで返します。error.code を確認し、メッセージ本文には依存しないでください。
重複防止
動画・画像の生成には、英数字、アンダースコア、ハイフンの 16–128 文字で構成する Idempotency-Key が必要です。業務処理とともに保存してください。同じ識別子と本文は再課金せず元の生成を返し、異なるパラメーターは 409 idempotency_conflict を返します。再試行と確認には同じ API キーを使用します。
主なレスポンス
| HTTP | Code | 対応 |
|---|---|---|
| 401 | invalid_api_key | キーを確認または更新。 |
| 403 | api_key_upgrade_required | 新しいキーを作成。 |
| 403 | server_side_only | サーバーから呼び出す。 |
| 403 | paid_account_required | 有効な有料プランまたは購入クレジットが必要。 |
| 404 | generation_not_found | ID と元のキーを確認。 |
| 409 | idempotency_conflict | 元の本文に戻す。 |
| 409 | cost_limit_exceeded | 料金と上限を確認。 |
| 413 | request_too_large | リクエストを小さくする。 |
| 422 | invalid_parameters | モデルの対応パラメーターを確認。 |
| 429 | rate_limit_exceeded / concurrency_limit_exceeded / daily_spend_limit_exceeded | Retry-After とアカウント上限に従う。 |
| 503 | api_unavailable / service_unavailable | 待って同じリクエストを再試行。 |
安全な再試行
ネットワーク障害、429、503 は待機して同じリクエストで再試行します。409 generation_rejected は送信前の拒否を明示します。問題を修正してから新しいリクエストを送ります。不明なタイムアウト時に別の生成を自動作成しないでください。IP あたり 1 分に 120 回を超えると、ファイアウォールが JSON 以外の 403 を返す場合があります。制限解除まで待ってください。