mingyanmingyan
微信微信
mingyan

Seedance2.0 特价版 - 创建任务

创建 Seedance2.0 特价版视频任务

POST/kyyReactApiServer/v1/seedance-special/videos

Seedance2.0 特价版创建任务

特价版请使用完整模型编码创建视频任务. 模型编码已包含模型类型, 分辨率, 以及是否包含视频参考.

认证

获取 Key
cURL
Authorization: Bearer {{key}}

基础 URL

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

请求参数

modelstring必填
模型名称. 使用 _with_video_ref 模型时, content 中必须包含 role=reference_video 的 video_url.
  • sd_2.0_special_720p
  • sd_2.0_special_1080p
  • sd_2.0_special_2k
  • sd_2.0_special_4k
  • sd_2.0_special_720p_with_video_ref
  • sd_2.0_special_1080p_with_video_ref
  • sd_2.0_special_2k_with_video_ref
  • sd_2.0_special_4k_with_video_ref
  • sd_2.0_fast_special_720p
  • sd_2.0_fast_special_720p_with_video_ref
sd_2.0_fast_special 仅支持 720p。
resolutionstring
可选字段. 完整模型编码已包含分辨率. 如传入该字段, 必须与模型编码中的分辨率一致.
ratiostring
输出比例，默认 16:9。常用值：16:9、9:16、1:1、4:3、3:4、21:9。
durationinteger
视频时长，单位秒，默认 5，范围 4-15。
generate_audioboolean
是否生成音频，默认 true。
return_last_frameboolean
是否返回尾帧图片，默认 false。设置为 true 且任务生成尾帧时，可在查询接口读取 last_frame_url。
toolsarray
高级工具配置，默认不传。不同模型或场景支持的工具能力可能不同，请按实际开通能力传入。
seedinteger
随机种子，默认 -1，表示由模型服务随机生成。传入固定值可提升生成结果的可复现性；模型生成仍存在概率性，不保证完全一致。
contentarray必填
多模态内容数组。必须包含一个 type=text 的提示词。
content[].typestring必填
内容类型：text、image_url、video_url、audio_url。
content[].rolestring
素材角色：first_frame、last_frame、reference_image、reference_video、reference_audio。
真人或虚拟人像图片建议先使用素材提交接口获取 assetId，再用 assetId://{assetId} 引用。

响应参数

idstring
视频生成任务 ID，用于查询任务状态和结果。
objectstring
对象类型，固定为 video。
createdinteger
任务创建时间戳。
modelstring
本次请求使用的模型名称。
statusstring
任务状态，创建成功后通常为 queued 或 processing。

状态说明

  • queued：任务已创建，等待处理。
  • processing：任务处理中。
  • completed：任务成功，可在查询接口中获取 video_url。
  • failed：任务失败，可在查询接口中查看 error。

请求报文示例

真人素材参考
{
  "model": "sd_2.0_fast_special_720p",
  "ratio": "16:9",
  "duration": 4,
  "return_last_frame": true,
  "generate_audio": true,
  "content": [
    {
      "type": "text",
      "text": "真人口播广告，人物自然看向镜头，表情自信，背景干净"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "assetId://202607041749401700000000"
      }
    }
  ]
}
多模态参考
{
  "model": "sd_2.0_fast_special_720p_with_video_ref",
  "ratio": "9:16",
  "duration": 5,
  "return_last_frame": true,
  "generate_audio": true,
  "tools": [
    {
      "type": "image_reference"
    }
  ],
  "content": [
    {
      "type": "text",
      "text": "第一人称视角果茶宣传广告，全程使用视频1构图和音频1作为背景音乐"
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.mp3"
      }
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      }
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    }
  ]
}