GlobalAiOpcGlobalAiOpc
微信微信
登录
GlobalAiOpc

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、adaptive。
durationinteger
视频时长，单位秒，默认 5，范围 4-15。
generate_audioboolean
是否生成音频，默认 true。
return_last_frameboolean
是否返回尾帧图片，默认 false。设置为 true 且任务生成尾帧时，可在查询接口读取 last_frame_url。
toolsarray
工具配置，默认不传。当前仅对外支持 Seedance 2.0 系列的联网搜索工具：{"type":"web_search"}。
tools[].typestring
工具类型。当前支持 web_search，其他工具类型当前不支持。
seedinteger
随机种子，默认 -1，表示由模型服务随机生成。传入固定值可提升生成结果的可复现性；模型生成仍存在概率性，不保证完全一致。
contentarray必填
多模态内容数组。必须包含一个 type=text 的提示词。
content[].typestring必填
内容类型：text、image_url、video_url、audio_url。
content[].textstring
当 content[].type=text 时必填，表示文本提示词。
content[].rolestring
素材角色：first_frame、last_frame、reference_image、reference_video、reference_audio。
content[].image_url.urlstring
图片地址。支持公网 URL 或我方素材引用 assetId://{assetId}；当前不支持 base64。
content[].video_url.urlstring
视频地址。支持公网 URL 或我方素材引用 assetId://{assetId}。
content[].audio_url.urlstring
音频地址。支持公网 URL 或我方素材引用 assetId://{assetId}；当前不支持 base64。
真人或虚拟人像素材建议先使用素材提交接口获取 assetId，并通过素材详情接口确认 status 为 ACTIVE 后，再用 assetId://{assetId} 引用并提交任务。其他状态下请勿提交任务。

暂不支持字段

当前分版接口不会透传 callback_url、priority、safety_identifier、service_tier、execution_expires_after、frames、camera_fixed、watermark、draft。请勿在请求中依赖这些字段；若后续开放，会在文档中明确说明。

素材与场景限制

  • 文本提示词：中文建议不超过 500 字，英文建议不超过 1000 词。
  • 图片输入：支持 jpeg、png、webp、bmp、tiff、gif、heic、heif；单张图片小于 30 MB，宽高比 (0.4, 2.5)，宽高长度 (300px, 6000px)。
  • 图片数量：首帧场景 1 张；首尾帧场景 2 张，分别使用 first_frame 和 last_frame；多模态参考场景 1-9 张 reference_image。
  • 视频输入：支持 mp4、mov；单个视频时长 [2, 15] 秒，最多 3 个参考视频，所有视频总时长不超过 15 秒；单个视频小于 50 MB；帧率 [24, 60]。
  • 音频输入：支持 wav、mp3；单段音频时长 [2, 15] 秒，最多 3 段参考音频，所有音频总时长不超过 15 秒；单段音频小于 15 MB。
  • 场景互斥：首帧、首尾帧、多模态参考（参考图、视频、音频）不可混用；音频不可单独输入，至少需要同时包含 1 个参考图片或视频。
  • 当前系统不支持 image/audio 的 base64 入参，请使用公网 URL 或素材提交接口返回的 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://asset-20260722164336-p4mms"
      }
    }
  ]
}
多模态参考
{
  "model": "sd_2.0_fast_special_720p_with_video_ref",
  "ratio": "9:16",
  "duration": 5,
  "return_last_frame": true,
  "generate_audio": true,
  "tools": [
    {
      "type": "web_search"
    }
  ],
  "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"
      }
    }
  ]
}