ToAPIsToAPIs
seedance-2-5

Seedance 2.5 ドラフトモード

低コストの 480p ドラフトで確認し、そのドラフトから 1080p の本番動画を生成する

POST
/v1/videos/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

ドラフトモードは 1 回の生成を 2 段階に分けます。まず低コストで 480p のドラフトを生成してカメラワークと構図を確認し、その後そのドラフトから 1080p の本番動画を生成します。本番生成では上流がドラフトのプロンプトと素材を再利用するため、2 段階目でこれらを再送する必要はありません。

どちらの段階も同じ seedance-2-5 モデルで POST /v1/videos/generations を呼び出します。

2 段階の流れ

  1. draft: true を付けてドラフトを送信し、応答からドラフトのタスク ID を取得します。
  2. ドラフトの完了を待ち、動画タスクの状態取得で status が completed であることを確認します。
  3. draft_task_id に手順 1 のタスク ID を指定して本番リクエストを送信します。プロンプトと素材は再送しないでください。

段階ごとの比較

項目ドラフト(draft: true)本番(draft_task_id)
対応モデルseedance-2-5 のみseedance-2-5 のみ
resolution常に 480p常に 1080p
output_formatmp4mp4 または mov
プロンプトと素材通常の生成と同じ受け付けないため省略必須
ドラフトの状態-正常に完了していること
ドラフトの有効期間-作成から 7 日以内
課金480p 料金1080p 料金。単価はドラフトリクエストに動画入力があったかで決まる

本番リクエストはドラフトと同じ model を使い、ドラフトのチャネルでドラフト機能が有効である必要があります。ドラフトが正常に完了していない、作成から 7 日を超えている、モデルが一致しない、またはチャネルの機能が無効になっている場合、本番リクエストは invalid_draft_task で失敗し、ドラフトの再生成が必要です。

Body

draftbooleanボディデフォルト: false

true でドラフトを送信します。ドラフトは 480p で生成され、その他のパラメータは通常の生成と同じです。

seedance-2-5 のみ対応します。他のモデルでは draft mode is only supported for Seedance 2.5 を返します。

draft_task_idstringボディ

本番リクエストでは必須です。ドラフトの応答が返すタスク ID(tsk_vid_...)を指定します。

draft: true とは同時に使用できません。draft_task_id を指定したら、prompt、image_urls、image_with_roles、video_with_roles、audio_with_roles は送信しないでください。送信すると draft requests cannot include prompt or media を返します。

resolutionstringボディ

ドラフトは 480p、本番は 1080p に固定されます。省略可能で、省略した場合は各段階の固定値が使われます。それ以外の値を明示すると拒否されます。

output_formatstringボディデフォルト: mp4

本番リクエストでのみ指定できます。mp4 と mov に対応します。

return_last_framebooleanボディデフォルト: false

本番リクエストはドラフトのラストフレーム設定を引き継ぎません。本番でもラストフレームが必要な場合は、本番リクエストで改めて true を指定してください。

その他のパラメータ(prompt、duration、aspect_ratio、generate_audio、参照素材など)は、ドラフト段階でもSeedance 2.5 の動画生成と同じように使用できます。

リクエスト例

以下の 2 つの例は、ドラフトの送信とそのドラフトからの本番生成の完全なリクエストです。順に実行してください。

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft": true,
    "prompt": "映画的な製品クローズアップ、カメラがゆっくり前進する。",
    "duration": 4,
    "resolution": "480p",
    "return_last_frame": true
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft_task_id": "tsk_vid_xxx",
    "resolution": "1080p",
    "output_format": "mp4",
    "return_last_frame": true
  }'

レスポンス例

{
  "id": "tsk_vid_xxx",
  "object": "generation.task",
  "model": "seedance-2-5",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}

課金

ドラフトと本番はそれぞれ別に課金され、各タスクの完了時に上流が報告した実際の token 使用量で精算されます。ドラフトは 480p 料金で、本番は 1080p 料金で精算されます。本番の単価はドラフトリクエストに動画入力があったかで決まります。ドラフトに参照動画があった場合は動画入力ありの単価が適用され、入力動画の長さはドラフトの元の入力動画で計算されます(ドラフト動画自体は入力に含まれません)。ドラフトに動画入力がなかった場合は動画入力なしの単価が適用されます。実際の請求額はタスク結果と料金と実際の費用を基準とします。