Base URL:
https://api.laozhang.ai/seedance/api/v3接口:POST /contents/generations/tasks:创建视频生成任务GET /contents/generations/tasks/{id}:查询任务状态与结果GET https://api.laozhang.ai/v1/videos/{id}/content:兼容下载已成功任务的视频文件
id,需要轮询查询接口;成功后可以从 content.video_url 读取签名下载地址,或使用 /v1/videos/{id}/content 直接下载视频文件。创建令牌
在 令牌管理 创建用于 Seedance 2.0 的令牌时,按下面配置:| 配置项 | 选择 |
|---|---|
| 计费模式 | 按量优先 |
| 选择分组 | SeeDance2 |
| 建议 | 为 Seedance 2.0 单独创建令牌,便于后续查看调用日志和扣费记录 |
计费与价格
以下为上游官方公开价格口径,用于接入前成本预估。LaoZhang API
实际扣费以控制台模型价格和调用日志为准;因税率、汇率、支付通道和上游结算差异,站内扣费可能在官方原价基础上上浮
0% - 10%。usage.completion_tokens 相关,不是固定的单次价格。官方估算公式:
官方价格示例
以下示例来自官方价格页,规格固定为16:9、输出 5 秒视频。
| 模型 | 输入条件 | 480p 官方示例 | 720p 官方示例 | 1080p 官方示例 |
|---|---|---|---|---|
doubao-seedance-2-0-260128 | 不含输入视频 | 2.31 元/个 | 4.97 元/个 | 12.39 元/个 |
doubao-seedance-2-0-fast-260128 | 不含输入视频 | 1.86 元/个 | 4.00 元/个 | 不支持 |
doubao-seedance-2-0-260128 | 包含 2-15 秒输入视频 | 2.53 - 5.62 元/个 | 5.44 - 12.10 元/个 | 13.56 - 30.13 元/个 |
doubao-seedance-2-0-fast-260128 | 包含 2-15 秒输入视频 | 1.99 - 4.42 元/个 | 4.28 - 9.50 元/个 | 不支持 |
包含
video_url
输入时,官方会把输入视频处理量和输出视频生成量一起纳入计费。最终费用应以任务查询响应中的
usage.completion_tokens、控制台账单和 LaoZhang API 调用日志为准。接口流程
状态值:
| 状态 | 说明 |
|---|---|
queued | 任务排队中 |
running | 任务生成中 |
succeeded | 任务成功,结果在 content 中 |
completed | LaoZhang 兼容任务对象中的成功终态,等价于 succeeded |
failed | 任务失败,查看 error |
expired | 任务过期 |
GET /contents/generations/tasks/{id} 的方舟透传结构以 status=succeeded 和
content.video_url 为准。LaoZhang 兼容任务对象可能同时出现
status=completed、顶层 result_url,以及嵌套的
data.content.video_url。客户端建议兼容这些成功结果。下载阶段建议保留
/v1/videos/{id}/content 作为稳定入口。模型
model 只填纯模型 ID。不要填写控制台接入点 ID,也不要在模型名后附加中文备注。
| 模型 ID | 说明 | 推荐用途 |
|---|---|---|
doubao-seedance-2-0-fast-260128 | Seedance 2.0 fast | 快速生成、文生视频、图片参考、视频参考、音频参考、多模态参考、视频延长、轨道补齐 |
doubao-seedance-2-0-260128 | Seedance 2.0 标准版 | 标准质量、首尾帧、视频编辑、对稳定性要求更高的任务 |
创建任务
/contents/generations/tasks
创建 Seedance 2.0 视频生成任务。
请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer $API_KEY,使用选择了 SeeDance2 分组的 LaoZhang API 令牌 |
Content-Type | 是 | application/json |
Accept | 建议 | application/json |
Accept-Encoding | 调试建议 | identity,可避免部分客户端调试时的压缩解码干扰 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 纯模型 ID,如 doubao-seedance-2-0-fast-260128 |
content | array | 是 | 多模态内容数组,文本提示词也放在这里 |
ratio | string | 否 | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive |
duration | integer | 否 | Seedance 2.0 支持 4 到 15 秒,也支持 -1 自适应 |
frames | integer | 否 | 按帧数控制输出,优先级高于 duration |
resolution | string | 否 | 常用 720p。Seedance 2.0 fast 不支持 1080p |
watermark | boolean | 否 | 是否添加水印 |
generate_audio | boolean | 否 | 是否生成或使用音频 |
return_last_frame | boolean | 否 | 成功后是否返回最后一帧图片 URL |
content 内容项
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | text、image_url、video_url、audio_url |
text | string | type=text 时必填 | 生成提示词 |
image_url.url | string | type=image_url 时必填 | 图片 URL |
video_url.url | string | type=video_url 时必填 | 视频 URL |
audio_url.url | string | type=audio_url 时必填 | 音频 URL |
role | string | 素材项建议填写 | 素材用途 |
role:
| role | 用途 |
|---|---|
first_frame | 首帧图片 |
last_frame | 尾帧图片 |
reference_image | 多模态参考图片 |
reference_video | 多模态参考视频 |
reference_audio | 多模态参考音频 |
文生视频
首尾帧
图片、视频、音频参考
查询任务
/contents/generations/tasks/{id}
查询视频生成任务状态。
结果 URL 是临时签名地址,通常有效期为 24
小时。生产环境建议任务成功后立即下载,并转存到自己的对象存储。
下载结果
/v1/videos/{id}/content
通过 LaoZhang 兼容下载接口下载已成功任务的视频文件。
https://api.laozhang.ai/v1,不是 /seedance/api/v3。任务成功后,该接口会根据服务端保存的任务结果定位视频文件,并返回或重定向到可下载的 MP4。
如果查询详情接口正常返回
content.video_url,可以直接下载该签名地址;如果查询响应体异常、没有解析到
URL,或只需要稳定拿到视频文件,建议使用 /v1/videos/{id}/content。Python 完整示例
常见接入问题
为什么 /seedance/v3/contents/generations/tasks 返回 HTML?
为什么 /seedance/v3/contents/generations/tasks 返回 HTML?
当前路径是
/seedance/api/v3/contents/generations/tasks。不要去掉官方路径里的 /api。模型名后面可以加中文备注吗?
模型名后面可以加中文备注吗?
不可以。请求里的
model 必须是纯模型 ID,例如
doubao-seedance-2-0-260128。不要写成 doubao-seedance-2-0-260128 (2.0-音画同生)。可以传 ep 接入点 ID 吗?
可以传 ep 接入点 ID 吗?
不建议。LaoZhang 中转按纯模型 ID 匹配通道,请不要传入
ep-...。任务成功后视频地址在哪里?
任务成功后视频地址在哪里?
方舟透传详情里的视频地址通常在
content.video_url。LaoZhang
兼容任务对象也可能返回顶层 result_url 或嵌套的
data.content.video_url。只需要下载文件时,调用兼容下载接口:/v1/videos/{id}/content音频参考能单独传吗?
音频参考能单独传吗?
不能。音频参考需要和至少一个图片或视频素材一起传入,否则请求会被官方接口拒绝。