Seedance 2.5 Draft サンプル動画生成ガイド

Draft サンプルを作成する

プラットフォームの作成 API にプロンプトまたは参照素材を渡し、draft: true と resolution: "480p" を設定します。返された task_id（id と同じ意味）を PLATFORM_DRAFT_TASK_ID として保存し、サンプルの取得に使用します。

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "text", "text": "白いウサギが紙飛行機に乗って雲の間を飛び、カメラが滑らかに前進する"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9"
  }'

サンプルを取得して確認する

プラットフォームのタスク ID で照会し、raw=true でネイティブタスクを取得します。status が queued/running の場合は待ってから再照会します。成功したら content.video_url をプレビューし、ネイティブレスポンスの id を DRAFT_TASK_ID として保存します。

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_DRAFT_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

第二段階で使用するのはネイティブのサンプル ID DRAFT_TASK_ID です。プラットフォームの照会用 ID と混同しないでください。失敗、キャンセル、期限切れの場合はポーリングを停止し、エラー情報を確認します。サンプルが succeeded の場合のみ続行できます。

サンプルから正式動画を作成する

サンプルを確認したら、同じ MODEL_ID を使用し、content.draft_task.id にネイティブのサンプル ID を指定します。解像度は 1080p に設定し、プロンプト、素材、長さなど自動継承されるパラメーターは再送信しないでください。

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

今回返された新しいプラットフォームのタスク ID を PLATFORM_FINAL_TASK_ID として保存します。サンプルと正式動画は別のタスクであり、ID も異なります。

正式動画を取得して保存する

新しいタスク ID で照会し、成功したらネイティブレスポンスの content.video_url から正式動画をダウンロードします。draft は false で、draft_task_id は使用したサンプルを示します。

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_FINAL_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

raw=true を省略して既定のプラットフォーム形式を使用する場合は、プラットフォームの取得 APIに従って data.status と結果 URL を読み取ってください。ネイティブレスポンスのフィールドパスをそのまま適用しないでください。