Seedance 2.5 Draft 樣片生成指南
先生成 480p 樣片確認效果，再透過 Draft 任務 ID 生成 1080p 正式影片。
Draft 樣片模式適合先確認場景、運鏡和主體動作，再生成正式影片。整個流程使用現有建立、查詢介面：先建立一份 480p 樣片，確認效果後引用樣片任務 ID，再建立一份 1080p 正式影片。
呼叫流程
選擇一種格式完成以下四步。請將 MODEL_ID 替換為目前 API Key 可用的 Seedance 2.5 模型，並將 Key 與任務 ID 預留位置替換為自己的值。兩次建立須使用相同模型和帳戶。
建立 Draft 樣片
透過平台建立介面傳入提示詞或參考素材，設定 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 直接當作原生樣片 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，請依平台格式查詢介面讀取 data.status 和結果網址；不要直接套用原生回應的欄位路徑。
正式生成時的參數規則
| 參數類別 | 欄位 | 正式生成時的處理 |
|---|---|---|
| 固定要求 | model、content.draft_task.id、resolution、draft | 使用相同模型和已成功的原生樣片 ID；解析度為 1080p；draft 省略或為 false |
| 自動繼承 | 提示詞、圖片/影片/音訊素材、duration、ratio、seed、generate_audio、omni_reference_task_type | 不要重複傳入，即使值與樣片階段相同也會報錯 |
| 可重新設定 | return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url、safety_identifier | 依正式影片需求設定；省略時使用本次請求的預設值，不保證沿用樣片設定 |
有效期與計費
- Draft 任務 ID 自
created_at起七天有效，過期後不能再用於生成正式影片。 - 樣片和正式影片是兩次生成任務，分別計費。樣片按 480p 生成計費，正式影片按目標解析度及輸入條件計費。
- 結果影片網址有效期為 24 小時，最多下載 100 次，請及時下載或轉存。
- 本指南適用於 Seedance 2.5，不適用於 Seedance 2.0。