Seedance 2.0低价渠道API文档（IP访问版）
目录
通用说明
认证方式
API Base URL
http://38.76.161.111:3099创建视频任务
seedance2-720 模型创建视频生成任务。接口支持纯文生、首尾帧、多图参考、视频参考和音频参考，最多支持 3 段音频。接口地址
POST http://38.76.161.111:3099/v1/videos模型介绍
seedance2-720：视频生成模型，按次计费，不管传入的入参是几秒，都是按一条视频9元（15秒）计费，支持多画幅和音频参考请求参数
基础参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称，固定为 seedance2-720 |
prompt | string | 是 | 视频生成提示词。建议避免违规、侵权、涉政、涉黄等高风险内容 |
duration | integer | 是 | 视频时长（秒），范围 4-15 秒 |
ratio | string | 否 | 输出比例，默认 16:9，支持：21:9、16:9、4:3、1:1、3:4、9:16 |
resolution | string | 否 | 输出分辨率，默认 720p，当前仅支持 720p |
首尾帧模式参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
first_image | string | 否 | 首帧图片 URL，仅用于首尾帧场景，必须搭配 last_image 使用 |
last_image | string | 否 | 尾帧图片 URL，必须搭配 first_image 使用 |
⚠️ 警告：不能与 referenceImages或referenceVideos同时使用；首尾帧模式不支持referenceAudios
ℹ️ 兼容说明： 历史字段 image和lastFrameImage仍可继续使用同时传新旧字段时，优先按 first_image/last_image处理同时传新旧字段且值不一致时，接口会返回参数冲突
引用 素材模式参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
referenceImages | array | 否 | 参考图片 URL 列表 |
referenceVideos | array | 否 | 参考视频 URL 列表 |
referenceAudios | array | 否 | 参考音频 URL 列表 |
autoFace | boolean | 否 | 是否为本次任务请求自动人脸处理，默认 false |
9 张20MBreferenceVideos 组合形成图/视频混合参考referenceAudios 组合，最多 3 段音频3 个15 秒200MB720px-2160px 之间3 段15 秒referenceImages、referenceVideos 组合形成多模态混合参考⚠️ 警告： referenceImages/referenceVideos不能与image或lastFrameImage同时使用超过模型支持的音频数量会直接报错；首尾帧模式不支持音频参考
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 视频生成任务的唯一标识符，用于后续查询任务状态 |
object | string | 对象类型，固定为 video |
created | integer | 任务创建时间戳 |
model | string | 使用的模型名称 |
status | string | 任务状态：queued（排队中）、processing（处理中）、completed（已 完成）、failed（失败） |
error | string | 错误信息，当状态为 failed 时返回 |
参数选择规则
⚠️ 互斥规则： 首尾帧模式： first_image和last_image必须成对使用引用素材模式： referenceImages、referenceVideos可单独或组合使用；referenceAudios最多 3 段模式互斥：首尾帧模式不能与引用素材模式或音频参考同时使用
使用场景
| 场景 | 说明 |
|---|---|
| 🪄 纯文生视频 | 仅传 prompt、model、duration 等基础参数 |
| 🎞️ 首尾帧视频 | 通过 first_image 和 last_image 精确控制开头与结尾画面 |
| 🖼️ 多模态混合参考 | 通过 referenceImages、referenceVideos 与 referenceAudios 组合提供更强的素材约束 |
模型特性
| 模型 | 计费方式 | 时长范围 | 素材能力 | 支持比例 |
|---|---|---|---|---|
seedance2-720 | 按次计费 | 4-15 秒 | 最多 9 张图、3 个视频、3 段音频 | 21:9、16:9、4:3、1:1、3:4、9:16 |
ℹ️ 最佳实践： 1.视频生成为异步处理，请保存创建返回的 id用于后续查询2.提示词尽量包含具体场景、动作、镜头和风格描述 3.使用首尾帧模式时，确保两张图片在风格和构图上连续 4.使用视频或音频参考时，优先提供清晰、时长较短、主体明确的素材
💡 提示词建议： 描述主体、动作和镜头语言 补充风格词，如"电影感""写实""梦幻" 如果有运动轨迹诉求，可直接写明镜头推进、转场或视角变化
请求示例
cURL - 图音频参考
cURL - 首尾帧模式
cURL - 图视频音频混合参考
Java
Python
响应示例
创建成功
{
"id": "video_1234567890",
"object": "video",
"created": 1774836724,
"model": "seedance2-720",
"status": "queued",
"error": null
}创建失败
{
"id": null,
"object": "error",
"created": 1774836724,
"model": null,
"status": "failed",
"error": "referenceAudios 最多支持 3 段，当前: 4"
}查询视频任务
接口地址
GET http://38.76.161.111:3099/v1/videos/{id}路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 视频生成任务的唯一标识符，从创建任务接口返回 |
📝 注意：创建接口直接返回字段 id，查询时请将该值作为这里的id使用。
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 视频生成任务的唯一标识符 |
object | string | 对象类型，固定为 video |
created | integer | 任务创建时间戳 |
model | string | 使用的模型名称 |
status | string | 任务状态：queued、processing、completed、failed |
video_url | string | 生成的视频 URL，当状态为 completed 时返回 |
actualDuration | number | 视频实际输出时长（秒），当状态为 completed 时返回 |
amount | number | 本次任务消耗的金额，由查询结果接口返回 |
error | string | 错误信息，当状态为 failed 时返回 |
状态流程
1.
2.
seedance2-720 模型正在生成视频3.
video_url 获取结果轮询建议
ℹ️ 轮询策略： 建议轮询间隔：30-60 秒 一般在数分钟内可完成，复杂素材参考场景可能更久 不要过于频繁轮询，避免触发限流 当状态为 completed或failed时停止轮询
结果说明
⚠️ 重要提示： 生成结果通常为临时下载地址，请及时保存 若使用较多图片、视频或音频参考素材，处理时间通常会更长 若提示词或参考素材不符合平台要求，任务可能直接失败
请求示例
cURL
Java
Python
响应示例
处理中状态
{
"id": "video_1234567890",
"object": "video",
"created": 1761635478,
"model": "seedance2-720",
"status": "processing",
"video_url": null,
"amount": 0.32,
"error": null
}已完成状态
{
"id": "video_1234567890",
"object": "video",
"created": 1761635478,
"model": "seedance2-720",
"status": "completed",
"video_url": "https://example.com/video.mp4",
"actualDuration": 8.0,
"amount": 0.32,
"error": null
}失败状态
{
"id": "video_1234567890",
"object": "video",
"created": 1761635478,
"model": "seedance2-720",
"status": "failed",
"video_url": null,
"amount": 0.32,
"error": "Generation failed: reference video resolution is not supported"
}修改于 2026-07-03 06:06:16