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:// 引用调用，并澄清“遮脸”是否必要、为什么直传人脸视频会被拦。