mingyan
Seedance1.5 - 创建任务
使用火山引擎 Seedance1.5 模型创建视频生成任务，支持文生视频和图生视频
Seedance1.5 创建视频任务
使用火山引擎 Seedance1.5（即梦）AI 模型创建高质量视频生成任务，支持文生视频、图生视频（首帧/首尾帧）等多种生成方式。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{YOUR_API_KEY}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。支持的模型
即梦 1.5 系列（按秒计费）
480p
seedance_1_5_pro_480p支持有声视频、图生视频
720p
seedance_1_5_pro_720p支持有声视频、图生视频
1080p
seedance_1_5_pro_1080p支持有声视频、图生视频
请求参数
modelstring必填模型名称，见上方支持的模型列表
contentarray必填输入内容数组，支持文本、图片格式。详见下方 content 数组结构说明
ratiostring视频宽高比
可选值：
16:9、4:3、1:1、3:4、9:16、21:9、adaptive默认值：
- 文生视频：
16:9（Seedance 1.5 Pro 为adaptive） - 图生视频：
adaptive
durationinteger视频时长（秒），支持 2-12 秒，默认为 5
Seedance 1.5 pro 特殊说明：
- 指定具体时长：4-12 秒的整数
- 自动选择时长：设置为
-1，模型自动选择 4-12 秒
Content 数组结构
文本内容对象
typestring必填固定值：
texttextstring必填文本提示词，中文不超过 500 字，英文不超过 1000 词
示例：
JSON
{
"type": "text",
"text": "小猫对着镜头打哈欠"
}
图片内容对象
typestring必填固定值：
image_urlimage_url.urlstring必填图片 URL
rolestring图片角色，根据使用场景选择：
first_frame或不填 - 首帧图片（图生视频-首帧）last_frame- 尾帧图片（图生视频-首尾帧）reference_image- 参考图片（Seedance 1.0 lite i2v，1-4 张）
图片要求：
- 格式：jpeg、png、webp、bmp、tiff、gif（Seedance 1.5 pro 支持 heic、heif）
- 宽高比：(0.4, 2.5)
- 尺寸：(300px, 6000px)
- 大小：< 30 MB
示例：
JSON
{
"type": "image_url",
"image_url": {
"url": "https://example.com/image.jpg"
},
"role": "first_frame"
}
响应参数
idstring视频生成任务 ID，保存 1 天，用于后续查询任务状态
objectstring对象类型，固定为
videocreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中completed- 已完成failed- 失败cancelled- 已取消
使用场景
文生视频
仅使用文本提示词生成视频
图生视频-首帧
使用 1 张图片作为首帧，配合文本生成视频
图生视频-首尾帧
使用 2 张图片作为首尾帧，控制视频起止画面
注意事项
重要限制：
- 图片场景互斥：首帧、首尾帧、参考图三种场景不可混用
- 有声视频功能仅支持 Seedance 1.5 pro 系列
- 任务 ID 保存 1 天，请及时保存生成的视频
最佳实践：
- 视频生成为异步处理，需要通过返回的
id查询任务状态和结果 - 选择合适的分辨率和时长以平衡质量和成本
- 图生视频时，图片质量直接影响生成效果