Seedance 2.5

Seedance 2.5（产品 seedance）用提示词、首尾帧，或者参考图、参考视频、参考音频生成视频，也可以编辑、续写一段已有的视频。出片默认带声音。五种模式各有一页说明，有各自的参数、价格和请求示例：

这一页是所有模式通用的规则。

创建任务

用所有模型共用的创建任务接口，model 传 "seedance-2.5"，mode 传上面的一种。所有模式都有的参数：

• 必传参数：所有模式都要传 resolution；text_to_video、image_to_video、reference_to_video 还要传 aspect_ratio；除了 video_edit，都要传 duration。prompt、image_urls、video_url、video_urls、audio_urls、extension_mode 是必填、可选还是不能传，每个模式不一样，见各模式的页面。
• 参数检查：参数不符合所选模式的规则时（例如 text_to_video 传了 image_urls、video_edit 传了 duration 或 aspect_ratio、video_extension 没传 extension_mode），返回 400 invalid_request，param 是对应的参数名，任务不会创建。
• 响应：200 OK，和所有模型一样是精简的任务对象（见创建任务的返回），data.model 是 seedance-2.5。保存 data.id，用它获取结果。
• 接口通常不到 1 秒返回，几秒内冻结费用。

获取结果

一般要几分钟出片（480p 约 4–6 分钟）。任务结束（成功或失败）后用下面任一方式拿结果：

• 回调（生产环境推荐）：创建时传了 webhook_url，任务结束时会把完整的任务推送一次，见回调。
• 轮询：用 data.id 调用 GET /v1/tasks/{task_id}，间隔 15 秒以上，直到 status 为 succeeded 或 failed；多个任务用列出任务的 ids 一次查询。

失败时冻结的钱全额退回，原因在 data.error.type，见错误。完整的字段见任务对象。

素材

所有素材都以公开的 http(s) 链接提交。不提供上传接口，请自行托管文件。链接最长 4096 字符，必须能直接下载，不能指向 localhost 或内网、回环、保留地址。

哪些必传见各模式的页面。素材要满足下面的要求：

素材下载不了、读不了（损坏、格式不支持）时，任务失败（invalid_media）。

Seedance 2.5 的所有素材都在任务提交给生成服务后才读取（创建后几秒内），这时已经冻结过费用，上面这些创建任务时都不检查；素材用不了时，冻结的费用全额退回。任务结束前所有链接都要保持可访问，有有效期的链接也不能提前过期。

在提示词里引用素材

价格

费用 = 出片时长 duration × 所选模式和分辨率的每秒单价

正在读取当前价格…

计费秒数就是请求的 duration（4–30 秒）；video_extension 是续写出来那一段的长度。和图片、视频、音频都无关：带参考视频、参考音频，出片带声音（generate_audio），都不额外收费。

• video_edit 不能传 duration：先冻结 30 × 每秒单价，任务成功后按实际出片时长扣费，多冻结的部分退回，见视频编辑 → 价格。

例如 720p 的 text_to_video，duration 为 5：冻结 5 × 它的 720p 每秒单价，成功后扣同样的金额，失败全额退回。冻结和扣费的通用规则见计费。

除了 video_edit，价格只由请求参数决定，提交前就能算出来：当前单价从 GET /v1/products 读取，prices 每个模式、每个分辨率一行（看这一行的 mode），价格会调整，不要写死；实际费用以查询任务返回的 billing.frozen 为准。

错误

Seedance 2.5 特有的错误和失败原因。创建任务的全部错误见创建任务 → 错误，全部失败原因见失败原因。

创建请求出错：请求返回 HTTP 错误，任务不会创建。

任务失败：创建请求成功（200），任务之后变成 failed。这种情况没有 HTTP 状态码，原因在任务的 error.type，通过查询任务或回调拿到。

error.message 只说要求，不说你的视频多长（例如 The video duration must be between 4 and 30 seconds.），全部说明见每种原因的 message。invalid_media、video_too_short、video_too_long 是在冻结之后失败的：billing.frozen 是冻结的金额，全额退回（refunded 等于 frozen），billing.charged 为 "0.00"。