Seedance
Seedance 2.0・2.5 のモデル、素材の制限、Draft 生成と課金。
POST /v1/video-generation/generate を使います。2.5 は追加モデルで、2.0 Pro と Fast も引き続き選べます。model を省略すると 2.0 Fast になります。
認証、ポーリング、一覧、エラーは AI 動画の概要.
モデル別の制限
| Model | RPM |
|---|---|
doubao-seedance-2-pro | 5 |
doubao-seedance-2-fast | 5 |
doubao-seedance-2-5 | 5 |
| 項目 | 2.0 Pro / Fast | 2.5 |
|---|---|---|
| プロンプト文字数 | 3000 | 5000 |
| 出力秒数 | 4–15 | 4–30 / -1 |
| 参照画像 | 9 | 30 |
| 参照動画 | 3 本、各 2–15 秒、合計 ≤15 秒 | 10 本、各 2–30 秒、合計 ≤30 秒。編集時は各 ≥4 秒 |
| 参照音声 | 3 件。画像または動画も必要 | 10 件、各 2–30 秒、合計 ≤30 秒。音声のみも可 |
| Resolution | Pro: 480p / 720p / 1080p; Fast: 480p / 720p | 480p / 720p / 1080p; Draft: 480p |
| アスペクト比 | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive |
2.5 のデフォルト:resolution: "720p"、ratio: "adaptive"、duration: 5、omniReferenceTaskType: "auto"、draft: false。
2.5 のモードと素材メタデータ
omniReferenceTaskType は auto(デフォルト)、reference、edit、extend です。編集と延長には動画入力と ratio: "adaptive" が必要です。編集には duration: -1 も必要です。先頭フレーム、先頭・末尾フレーム生成も adaptive を使います。adaptive は出力サイズ、-1 は長さをプロバイダーに任せる明示的な値です。複数動画を使う編集ではプロンプトで対象を指定してください。
first_frame は 1 枚、last_frame は任意で 1 枚です。フレームと参照画像・動画・音声は混在できません。参照用の役割は reference_image、reference_video、reference_audio です。
各素材のメタデータは image_url、video_url、audio_url オブジェクトの url と同じ階層に指定します。動画と音声はそれぞれ duration(秒)が必須です。実際の width、height、size(バイト)、動画の fps も分かる場合は指定してください。合計時間だけでは各素材のメタデータを代用できません。
画像:各辺 300–6000 ピクセル、比率 0.4–2.5(境界を含む)、30 MiB 未満。動画:各辺 300–6000、比率 0.4–2.5、面積 407,696–8,295,044 ピクセル、24–60 fps、最大 200 MiB。音声は最大 15 MiB。動画と音声の合計時間は、それぞれ 30 秒以内です。
2.5 の参照生成リクエスト
{
"model": "doubao-seedance-2-5",
"content": [
{ "type": "text", "text": "Use Video 1 motion and Audio 1 rhythm" },
{
"type": "video_url",
"role": "reference_video",
"video_url": {
"url": "https://example.com/reference.mp4",
"width": 1280,
"height": 720,
"duration": 5,
"fps": 24,
"size": 8000000
}
},
{
"type": "audio_url",
"role": "reference_audio",
"audio_url": {
"url": "https://example.com/reference.wav",
"duration": 4,
"size": 800000
}
}
],
"omniReferenceTaskType": "reference",
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"requestId": "reference-request-unique-id"
}Draft → 本生成
draft: true と resolution: "480p" で再生可能な草稿を作り、success までポーリングします。作成から 14 日以内に ListenHub の taskId を draftTaskId として指定し、新しい 1080p 本生成タスクを作れます。草稿は同じユーザーとアプリ/API ID の範囲に属する必要があります。元の入力とチャネルはサーバーが復元するため、本生成では内容や他の生成設定を省略します。
{
"model": "doubao-seedance-2-5",
"draftTaskId": "507f1f77bcf86cd799439011",
"requestId": "final-request-unique-id"
}新しい生成ごとに新しい requestId(8–128 文字)を使い、同じ送信のネットワーク再試行では再利用します。UUID が使えます。タスク詳細には任意の draft、draftTaskId、finalTaskIds があり、閲覧可能な生成結果の draftEpisodeId、finalEpisodeIds が含まれる場合もあります。
見積もりと精算
草稿と本生成は別タスクとして個別に課金されます。草稿代金の差し引きや、草稿出力の参照動画への加算はありません。本生成が失敗した場合、そのタスクの仮引き落としだけが返還され、成功済みの草稿は残ります。
POST /v1/video-generation/estimate-credits に生成と同じモデル、解像度、比率、長さ、omniReferenceTaskType、draft を渡します。referenceImages、referenceVideos、referenceAudios は role と各素材のメタデータを持つ配列で、URL は含めません。本生成の見積もりは model と draftTaskId だけで行います。
動画の見積もりは入力動画の合計秒数と出力秒数、出力サイズ、24 fps を使い、最小トークン規則を適用します。入力動画のサイズは各素材の検証に使い、その画素面積ごとに個別課金するわけではありません。音声のみの場合は動画入力なしの単価を使い、音声秒数は動画秒数に加算しません。自動設定では保守的に見積もり、完了後に実際のトークン使用量で精算します。見積もりは上限保証ではありません。
2.5 は独立した単価表を使います。2.0 Pro と比べて、480p / 720p の単価は動画入力なしで 52.86%、ありで 48.84% 上がります。1080p はそれぞれ 51.95%、48.94% です。すべてのタスクの増額率や一定の利益率を示す値ではありません。
OpenAPI の見積もりは tokens と estimatedCostUsd を返し、内部クレジットは返しません。送信時に仮引き落としし、実際のトークン使用量との差額を返還または追加請求します。タスク ID を保存し、再試行前に状態を確認してください。
失敗と再試行
素材ごとの長さの欠落、フレームと参照役割の混在、モードと比率・長さの不一致はリクエスト検証で失敗します。例えば edit と duration: 5 は無効です。adaptive と -1 を使います。
草稿が存在しない、またはアクセスできない場合は 32001、未成功・期限切れ・条件不一致の場合は 32004 です。例えば作成から 14 日を過ぎた草稿は本生成できないため、新しく作り直します。
プロバイダーの審査拒否や失敗はタスクの失敗状態と既存のエラーフィールドで返ります。5000 文字は製品上限であり、プロバイダーの受理を保証しません。送信のタイムアウト時は新規作成せず、既存タスクを確認するか同じリクエスト ID で再試行してください。