GlobalAiOpcGlobalAiOpc
微信微信
GlobalAiOpc

Seedance2.0 - 创建任务

使用 Seedance2.0 模型创建视频生成任务，支持标准、快速、Pro 等多种模型

POST/kyyReactApiServer/v1/kyyvideo2/videos

Seedance2.0 创建视频任务

使用 Seedance2.0 的先进 AI 模型创建高质量视频生成任务，支持多种模型选项和多模态参考输入。

认证

获取 Key
所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelstring必填
模型名称，可选值：
  • seedance_2_0 - 标准模型（仅支持带参考视频生成）
  • seedance_2_0_fast - 快速模型（仅支持带参考视频生成）
  • seedance_2_0_pro - Pro 模型（可选参考视频）
  • seedance_2_0_fast_pro - Fast Pro 模型（可选参考视频）
promptstring必填
视频生成提示词，描述所需的视频内容
示例："一只猫在雨中跳舞，电影风格"
durationinteger
视频时长（秒），默认 5 秒，范围 4-15 秒
first_imagestring
首帧图 URL，用于图生视频场景
使用场景：
  • 单独使用：图生视频-首帧场景
  • 搭配 last_image：首尾帧场景
格式要求：
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
与 referenceImages/referenceVideos/referenceAudios 互斥
last_imagestring
尾帧图 URL，用于首尾帧场景
格式要求：
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
必须搭配 first_image 使用
aspect_ratiostring
输出视频宽高比，默认 16:9
可选值：
  • 16:9 - 横屏
  • 4:3 - 标准
  • 1:1 - 正方形
  • 3:4 - 竖屏
  • 9:16 - 竖屏
  • 21:9 - 超宽屏
  • adaptive - 自适应
generateAudioboolean
是否生成同步音频，默认 true
  • true：输出视频包含同步音频
  • false：输出视频为无声视频
referenceAudiosarray
多模态参考音频列表
格式要求：
  • 格式：wav、mp3
  • 时长：单个音频 2-15 秒，最多 3 段，总时长 ≤ 15 秒
  • 大小：单个 ≤ 15 MB
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
与 first_image/last_image 互斥
referenceImagesarray
多模态参考图片列表
格式要求：
  • 数量：1-9 张
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
涉及人脸或虚拟人像需先上传素材库审核
与 first_image/last_image 互斥
referenceVideosarray
多模态参考视频列表
格式要求：
  • 分辨率：480p、720p
  • 时长：单个视频 2-15 秒，最多 3 个，总时长 ≤ 15 秒
  • 宽高比（宽/高）：0.4 ~ 2.5
  • 尺寸：300-6000 px
  • 值类型：公网 URL 或素材 ID（asset://素材ID）
系统会自动选择最优后端模型
与 first_image/last_image 互斥

响应参数

idstring
视频生成任务的唯一标识符，用于后续查询任务状态
objectstring
对象类型，固定为 video
createdinteger
任务创建时间戳
modelstring
使用的模型名称
statusstring
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
errorstring
错误信息，当 status 为 failed 时返回

模型特性

seedance_2_0

标准模型，仅支持带参考视频生成

seedance_2_0_fast

快速模型，仅支持带参考视频生成，生成速度更快

seedance_2_0_pro

Pro 模型，可选参考视频，质量更高

seedance_2_0_fast_pro

Fast Pro 模型，可选参考视频，速度与质量兼顾

参数选择规则

参数互斥规则：
  • 首尾帧场景：使用 first_image 和 last_image 时，不能使用 referenceImages、referenceVideos、referenceAudios
  • 多模态参考：使用 referenceImages、referenceVideos、referenceAudios 时，不能使用 first_image、last_image

模型功能对比

模型参考视频支持生成速度视频质量
seedance_2_0✅ 仅支持带参考视频标准标准
seedance_2_0_fast✅ 仅支持带参考视频快速标准
seedance_2_0_pro⭕ 可选参考视频标准高质量
seedance_2_0_fast_pro⭕ 可选参考视频快速高质量
最佳实践：
  1. 视频生成为异步处理，需要通过返回的 id 查询任务状态和结果
  2. 在提示词中明确描述所需的视觉效果和风格
  3. 根据需求选择合适的模型：需要参考视频时选择标准或快速模型，追求质量时选择 Pro 模型
  4. 参考图片涉及人脸时，需先上传素材库进行审核
  5. 合理设置视频时长（4-15 秒），时长越短生成越快
提示词建议：
  • 包含具体的场景描述
  • 添加风格关键词（如 "电影风格"、"艺术风格"、"写实风格"）
  • 描述动作和运动方式
  • 指定光照和色彩偏好