Seedance 2.5 樣片模式已上線 API易：2 步完成 480p 樣片到 1080p 成片的調用說明

作者注：本文講解 Seedance 2.5 樣片模式的兩階段調用方法。先低成本生成 480p 樣片，確認效果後再生成 1080p 成片，附可直接運行的請求示例。

做 AI 視頻生成時，最常見的問題是直接跑高清成片，結果構圖、運鏡或主體動作不理想，只能重新生成，時間和費用都浪費了。2026 年 10 月 25 日，API易 文檔補充了 Seedance 2.5 樣片模式（Draft Mode）的完整調用說明。這個模式讓你先用 480p 樣片驗證創意，滿意後再憑樣片任務 ID 生成 1080p 成片。

這不是新的獨立接口。樣片模式沿用 Seedance 現有的異步任務接口，只需要在請求體裏增加 draft: true，或在第二階段引用樣片任務 ID。已經接入 Seedance 的項目，改動量很小。

核心價值：讀完本文，你將掌握 Seedance 2.5 樣片模式的兩階段調用流程、關鍵參數、計費規則和使用限制，並能把”先看樣片、再出成片”的工作流接入自己的視頻生產管線。

Seedance 2.5 樣片模式核心要點

按照 API易 文檔中心的說明，Seedance 2.5 樣片模式的關鍵信息可以歸納爲下表：

Seedance 2.5 樣片模式爲什麼值得用

視頻生成和文本生成有一個明顯區別：單次生成耗時長、成本高，而且結果的隨機性更強。一條提示詞寫得再細緻，模型對鏡頭節奏、主體動作的理解也可能和預期不同。如果每次都直接生成 1080p，一旦不滿意就是一次完整的成片開銷。

樣片模式把流程拆成”試拍”和”正式拍攝”兩步。480p 樣片足以判斷畫面主體、運鏡方向和整體氛圍，確認沒問題後再基於這條樣片生成 1080p 成片。對於批量生產短視頻、廣告素材或分鏡預覽的團隊來說，這種做法能明顯降低廢片率。

Seedance 2.5 樣片模式的兩階段關係

需要注意的是，成片並不是把樣片簡單放大。第二階段是一個新的生成任務，它通過 draft_task.id 引用樣片任務，繼承樣片階段的相關設置，再按 1080p 輸出。哪些參數會被繼承、哪些參數不能在第二階段修改，以 API易 文檔中”參數繼承與限制”部分爲準。

Seedance 2.5 樣片模式快速上手

開始前，請先在 API易 apiyi.com 控制檯創建 API Key，並把它設置爲環境變量 APIYI_API_KEY。下面的示例都通過環境變量讀取密鑰，避免把 Key 寫進代碼。

第一步：生成 480p 樣片

以下是創建樣片任務的最簡請求。關鍵在於 "draft": true，同時把分辨率設爲 480p：

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一隻橘貓在窗邊伸懶腰，陽光灑在木地板上，鏡頭緩慢推進"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

接口是異步的，創建成功後會返回一個任務 ID。你需要保存這個 ID，後續既要用它查詢樣片結果，也要用它生成成片。

第一步請求參數說明

請求頭裏的 Accept-Encoding: identity 用於要求服務端不壓縮響應，便於部分客戶端直接解析結果，建議保留。

第二步：查詢樣片任務狀態

樣片任務創建後需要輪詢查詢，直到狀態變爲成功並拿到視頻地址。查詢沿用現有異步任務接口，通常是對任務地址加任務 ID 發起 GET 請求，具體路徑和返回字段以 API易 文檔爲準：

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

輪詢間隔建議設置在 5-10 秒之間，過於頻繁的查詢沒有意義，反而可能觸發限流。

第三步：憑樣片任務 ID 生成 1080p 成片

確認樣片效果滿意後，在 content 數組中通過 draft_task.id 引用樣片任務，並把分辨率設爲 1080p：

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

這裏的 YOUR_DRAFT_TASK_ID 替換爲第一步返回的樣片任務 ID。content 元素中 type 字段的取值以及其他可選參數，請對照文檔中的兩階段請求示例覈對。成片任務同樣是異步的，用第二步的方式查詢即可拿到 1080p 視頻。

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # API易 Seedance 異步任務接口
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """創建異步任務，返回任務 ID"""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """輪詢任務狀態，直到成功或失敗"""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"任務結束但未成功: {data}")
        time.sleep(interval)
    raise TimeoutError(f"任務 {task_id} 輪詢超時")


def generate_draft(prompt: str) -> str:
    """第一階段：生成 480p 樣片"""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("樣片結果:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """第二階段：憑樣片任務 ID 生成 1080p 成片"""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("一隻橘貓在窗邊伸懶腰，陽光灑在木地板上，鏡頭緩慢推進")
    ok = input("樣片是否滿意？(y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("成片結果:", final.get("content"))
    else:
        print("請調整提示詞後重新生成樣片。")

🚀 快速開始：建議先在 API易 apiyi.com 領取新用戶免費測試額度，用 480p 樣片把提示詞打磨穩定，再批量生成 1080p 成片。平臺使用統一的 API Key 計費，便於管理多個視頻項目的調用成本。

Seedance 2.5 樣片模式與直接出成片對比

是否使用樣片模式，取決於你的業務對效果確定性和交付速度的要求。下表對比兩種調用方式：

Seedance 2.5 樣片模式對比解讀

直接出成片在流程簡潔性上保持優勢，一次請求就能拿到最終視頻。但只要畫面主體或運鏡不理想，整條 1080p 成片的費用和等待時間就白費了。相比之下，樣片模式把試錯放在低分辨率階段，更適合需要多輪調整提示詞、或需要客戶先確認方向的項目。

如果你的提示詞模板已經過大量驗證，生成結果相對穩定，直接出成片也是合理選擇。比較務實的做法是：新創意、新模板走樣片模式；成熟模板走直接生成，兩種方式在同一套異步接口裏可以隨時切換。

💡 選擇建議：兩種方式的實際效果差異，建議用你自己的業務提示詞各跑幾組對比。通過 API易 apiyi.com 調用時兩種模式共用同一個接口和 Key，切換隻需修改請求體參數。

Seedance 2.5 樣片模式接入注意事項

把樣片模式接入生產環境時，有幾個細節容易被忽略。下表彙總了常見注意點：

Seedance 2.5 樣片模式的工作流設計建議

在團隊協作場景中，推薦把樣片模式拆成”生成—審覈—放行”三段式流程。系統批量生成樣片後推送給審覈人員，審覈通過的樣片任務 ID 進入成片隊列，被駁回的則帶着修改意見回到提示詞調整環節。這樣能把人工判斷集中在低成本的樣片階段。

對於自動化程度更高的管線，也可以在樣片階段接入多模態模型做初篩，例如判斷畫面中是否出現指定主體、是否存在明顯畸變。初篩通過後再交給人工確認，進一步減少人工審覈量。由於 API易 同時提供多家主流模型的統一接口，視頻生成和多模態審覈可以用同一個 Key 完成。

常見問題 FAQ

Seedance 2.5 樣片模式核心要點 Key Takeaways

• 兩階段流程：先傳 draft: true 生成 480p 樣片，再引用任務 ID 出 1080p 成片
• 接口不變：沿用 Seedance 現有異步任務接口，已接入項目改動很小
• 關鍵字段：成片階段通過 content[].draft_task.id 引用樣片任務
• 計費規則：樣片與成片分別計費，只爲滿意的樣片付成片費用
• 時效限制：樣片任務 ID 有效期爲 7 天，需及時審覈放行
• 適用場景：創意探索、客戶確認、批量素材篩選收益最明顯
• 上手方式：在 API易 apiyi.com 領取免費額度，用本文示例跑通完整流程

總結

Seedance 2.5 樣片模式的核心要點：

1. 先試後拍：用 480p 樣片低成本驗證構圖和運鏡，降低 1080p 廢片率
2. 接入簡單：只需增加 draft 參數和 draft_task.id 引用，複用現有異步接口
3. 注意時效與計費：樣片 ID 7 天內有效，樣片和成片分別計費

如果你的視頻業務經常需要反覆調整提示詞，樣片模式值得儘快接入。建議先挑幾條典型提示詞跑一遍”樣片 → 成片”流程，評估效果和成本後再推廣到批量生產。

推薦通過 API易 apiyi.com 快速驗證 Seedance 2.5 樣片模式的實際效果，平臺提供 OpenAI 兼容接口、按量計費和新用戶免費測試額度。

📚 參考資料

1. API易 Seedance 2 視頻生成文檔 – 樣片模式：Seedance 2.5 樣片模式官方調用說明
2. 鏈接：docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. 說明：包含兩階段請求示例、參數繼承與限制、計費與有效期說明

4. API易 文檔中心：平臺全部模型接口文檔

5. 鏈接：docs.apiyi.com
6. 說明：可查看 Seedance 模型選型概覽及其他模型的調用方式

作者：APIYI 技術團隊
技術交流：接入過程中遇到問題，歡迎在 API易 apiyi.com 網站首頁聯繫我們，更多資料可訪問 docs.apiyi.com 文檔中心

延伸閱讀

• 帶人臉視頻生成/編輯 SeeDance2.5 實戰：3 步完成真人素材入庫與合規調用:講清 SeeDance2.5 帶人臉視頻生成與編輯的正確路徑：真人素材入庫、獲取 Asset ID、用 asset:// 引用調用，並澄清“遮臉”是否必要、爲什麼直傳人臉視頻會被攔。