mingyanmingyan
mingyan

Seedance X1 - 创建任务

使用 Seedance X1 创建视频生成任务,支持首帧、首尾帧和多模态参考输入

POST/kyyReactApiServer/v1/seedance-x1/videos

Seedance X1 创建视频任务

使用 Seedance X1 创建视频生成任务。请求体采用 content[] 结构,支持文本提示词、图片、视频和音频参考。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

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

请求参数

modelstring必填
用户侧模型名,可选值:
  • seedance_2_0_x1_official
  • seedance_2_0_x1_discount
  • seedance_fast_2_0_x1_official
  • seedance_fast_2_0_x1_discount
resolutionstring
输出分辨率,默认 720p
可选值:
  • 480p
  • 720p
  • 1080p
ratiostring
输出视频宽高比,默认 16:9
可选值:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
durationinteger
视频时长(秒),默认 5,范围 4-15
contentarray必填
内容列表,必须包含一个 type=text 的提示词项,并至少包含一张图片或一个参考素材。
content[].typestring必填
内容类型,可选值:
  • text
  • image_url
  • video_url
  • audio_url
content[].textstring
文本提示词。当 content[].type=text 时必填。
content[].rolestring
素材语义角色。
image_url 支持:
  • first_frame
  • last_frame
  • reference_image
video_url 支持:
  • reference_video
audio_url 支持:
  • reference_audio
content[].image_url.urlstring
图片 URL 或素材 ID。当 content[].type=image_url 时必填。
未指定 role 的单个图片会按首帧图处理。
content[].video_url.urlstring
视频 URL 或素材 ID。当 content[].type=video_url 时必填。
content[].audio_url.urlstring
音频 URL 或素材 ID。当 content[].type=audio_url 时必填。

响应参数

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

参数规则

content 组合规则:
  • content 必须包含 type=text 的提示词项
  • 暂不支持纯文本生成,至少需要一张图片或一个参考素材
  • last_frame 必须搭配 first_frame 使用
  • 首尾帧场景不能与 reference_imagereference_videoreference_audio 混用
  • reference_audio 不能单独使用,必须搭配 reference_imagereference_video
暂不支持 callback_urlprioritysafety_identifierservice_tierexecution_expires_aftertoolsgenerate_audioreturn_last_frameseedwatermark 等顶层字段。

模型说明

模型说明支持分辨率
seedance_2_0_x1_official标准系列480p720p1080p
seedance_2_0_x1_discount标准特价系列480p720p1080p
seedance_fast_2_0_x1_official快速系列480p720p1080p
seedance_fast_2_0_x1_discount快速特价系列480p720p1080p