创建旧版视频任务
http
POST /v1/videos
Authorization: Bearer <API_KEY>
Content-Type: application/json请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 旧版模型名;视频参考使用对应的 -v2v 模型 |
content | array | 是 | 文本和参考素材列表 |
resolution | string | 否 | Pro 可用 480p、720p、1080p;Fast、Mini 可用 480p、720p |
ratio | string | 否 | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive |
duration | integer | 否 | 4~15 秒,或 -1;未传时平台按 5 秒处理 |
generate_audio | boolean | 否 | 是否生成同步音频 |
watermark | boolean | 否 | 是否添加水印 |
return_last_frame | boolean | 否 | 是否在完成结果中返回尾帧 |
seed | integer | 否 | 随机种子 |
callback_url | string | 否 | 任务状态回调地址 |
content[] 支持 text、image_url、video_url 和 audio_url。普通参考图、参考视频和参考音频分别使用 reference_image、reference_video、reference_audio。旧版素材库中的素材使用 asset://<asset_id> 引用。
duration=-1 表示由 Seedance 2.0 在 4~15 秒范围内自动选择最终整数时长。
素材与场景限制
- 参考图片最多 9 张;单张
<30 MB,宽高各 300~6000 px,宽高比 0.4~2.5。 - 参考视频最多 3 个;单个 2~15 秒,总时长不超过 15 秒;MP4/MOV,单个
<=200 MB,24~60 FPS。 - 参考音频最多 3 段;单段 2~15 秒,总时长不超过 15 秒;WAV/MP3,单段
<=15 MB。 - 2.0 不支持仅音频输入;使用参考音频时,至少同时提供一张参考图片或一个参考视频。
- 普通参考图或视频不能直接携带未授权真人人脸;真人场景需使用已授权素材、预置虚拟人像或官方允许二次创作的受信模型原始产物。
- 严格首帧、严格首尾帧、全模态参考三类场景互斥,不要在同一请求中混用
first_frame/last_frame与普通参考图、视频、音频。
限制来源:火山方舟—创建视频生成任务。旧版渠道如有更严限制,以实际接口响应为准。
文生视频
json
{
"model": "seedance-2.0-pro",
"content": [
{"type": "text", "text": "一只橘猫从窗台跳下,电影感跟拍镜头"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true,
"watermark": false
}参考图片
json
{
"model": "seedance-2.0-pro",
"content": [
{"type": "text", "text": "保持人物身份和服装一致,缓慢走向镜头"},
{
"type": "image_url",
"image_url": {"url": "asset://asset_image"},
"role": "reference_image"
}
],
"resolution": "720p",
"ratio": "adaptive",
"duration": 5
}视频参考
视频参考必须选用模型名带 -v2v 的版本,并提供至少一个 video_url:
json
{
"model": "seedance-2.0-pro-v2v",
"content": [
{"type": "text", "text": "参考原视频的动作、运镜和节奏,保持人物一致"},
{
"type": "video_url",
"video_url": {"url": "asset://asset_video"},
"role": "reference_video"
}
],
"resolution": "720p",
"ratio": "adaptive",
"duration": 5
}普通生成选择不带 -v2v 的模型;视频参考选择对应的 -v2v 模型并提交 video_url。
Mini 也遵循相同规则:普通生成使用 seedance-2.0-mini,一旦请求中加入参考视频,就使用 seedance-2.0-mini-v2v。
创建响应
json
{
"id": "task_xxx",
"object": "video",
"model": "seedance-2.0-pro",
"status": "queued",
"progress": 0,
"created_at": 1787535000
}取得 id 后,请使用旧版查询接口轮询任务。