APIAPI
登录
Model CenterAPI

sd_2.5_special_v1

POST/kyyReactApiServer/v2/model-center/tasks

素材库

使用说明：为防止因图片、视频、音频资源审核导致任务失败问题，请先将资源上传素材库后再进行使用。

模型信息

字段值
模型 ID（model）sd_2.5_special_v1
模型类型视频模型
请求时 model 字段必须填写上表中的“模型 ID”，填写“模型名称”会导致找不到模型。

认证

获取 Key
所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer <API_KEY>

请求参数

以下参数放在请求体（JSON）中提交。model 为必填，取值请使用上方“模型信息”中的模型 ID。
promptstring必填
提示词
文本提示词输入。
最小值：1
reference_imagesimage[]
参考图
参考图.
取值范围：0 – 30
数量：0 - 30
支持传入公开可访问的资源在线 URL。
reference_videosvideo[]
参考视频
参考视频输入。
取值范围：0 – 10
数量：0 - 10
支持传入公开可访问的资源在线 URL。
reference_audiosaudio[]
参考音频
参考音频输入。
取值范围：0 – 10
数量：0 - 10
支持传入公开可访问的资源在线 URL。
durationinteger必填
时长
视频生成时长。
取值范围：4 – 30
默认值：4
aspect_ratiostring
画幅比例
输出画幅比例。
可选值：16:9、9:16、1:1、4:3、3:4、21:9、adaptive
默认值：16:9
resolutionstring
分辨率
输出分辨率档位。
可选值：720p、1080p
默认值：720p
seedinteger
随机种子
可复现生成的随机种子。
默认值：-1
first_imageimage[]
首帧图
图生视频首帧输入。
取值范围：0 – 1
数量：0 - 1
支持传入公开可访问的资源在线 URL。
last_imageimage[]
尾帧图
视频尾帧约束输入。
取值范围：0 – 1
数量：0 - 1
支持传入公开可访问的资源在线 URL。
generate_audioboolean
生成音频
是否生成视频音频轨。
默认值：true
omni_reference_task_typestring
提示词
任务类型引导 Seedance 2.5 全模态参考生视频任务包括参考生视频、视频编辑和视频延长 3 类子任务。不同任务类型对参数有特殊限制，为减少任务创建后异步报错的情况，可通过本参数指定子任务类型，以提前校验对应限制。 默认情况下，即 omni_reference_task_type=auto：模型根据输入素材和提示词自动判定任务类型，再校验参数取值。如果参数与实际任务类型不兼容，任务将触发 异步报错（错误码：InvalidParameter.TaskTypeConstraint）。 显式指定任务类型，即 omni_reference_task_type 为 reference、edit 或 extend：接口在提交任务时提前校验对应任务的特殊参数限制。不符合要求时，接口立即报错，任务不会创建。 注意 实际处理任务时，模型仍会进一步结合提示词判断任务类型。若实际判定的任务类型和指定的不一致，仍会触发 异步报错（错误码：InvalidParameter.TaskTypeMismatch）。建议遵循各任务类型的 提示词写法，降低报错概率。 可选值： auto：由模型根据输入素材和提示词自动判定任务类型。 reference：参考生视频任务，即基于参考图片、参考视频或参考音频生成新视频。设置 reference 时，ratio 或 duration 无特殊限制。 extend：视频延长任务，即对原视频向前或向后延长。设置 extend 时，content 中必须至少包含一个 reference_video；ratio 必须为 adaptive。
可选值：auto、reference、extend
return_last_frameboolean
提示词
是否要求返回尾帧。查询结果中的 lastFrameUrl 用于读取尾帧地址。
默认值：false
toolsarray
提示词
官方工具配置

素材与场景限制

  • 文本提示词：中文建议不超过 500 字，英文建议不超过 1000 词。
  • 图片输入：支持 jpeg、png、webp、bmp、tiff、gif、heic、heif；单张图片小于 30 MB，宽高比 (0.4, 2.5)，宽高长度 (300px, 6000px)。
  • 图片数量：首帧场景 1 张；首尾帧场景 2 张；多模态参考场景 1-9 张。
  • 视频输入：支持 mp4、mov；单个视频时长 [2, 15] 秒，最多 3 个参考视频，所有视频总时长不超过 15 秒；单个视频小于 50 MB；帧率 [24, 60]。
  • 音频输入：支持 wav、mp3；单段音频时长 [2, 15] 秒，最多 3 段参考音频，所有音频总时长不超过 15 秒；单段音频小于 15 MB。
  • 场景互斥：首帧、首尾帧、多模态参考（参考图、视频、音频）不可混用；音频不可单独输入，至少需要同时包含 1 个参考图片或视频。
  • 当前系统不支持 image/audio 的 base64 入参，请使用公网 URL 或素材提交接口返回的 assetId。
该模型所属分组支持 Seedance2.0 素材库。API 用户需要先调用素材提交接口获取 assetId，审核通过后在生成请求的媒体 URL 中使用 assetId://{assetId}。

返回约定

任务状态统一为 queued、processing、completed、failed。查询结果只有在 status 为 completed 时返回结果 URL；
字段说明
id任务 ID，用于查询任务状态和结果。
object资源类型，当前模型通常为 video。
created任务创建时间，Unix 秒级时间戳。
model本次调用的模型名称。
statusqueued、processing、completed、failed。
progress任务进度，查询接口可能返回。
result_url通用结果 URL，仅完成后返回。
video_url按资源类型返回的结果 URL，仅完成后返回。
amount本次任务消耗积分。
actualDuration本次任务所用时长。
error_message模型配置公开的附加结果字段。
last_frame_url模型配置公开的附加结果字段。
media_url模型配置公开的附加结果字段。
task_id模型配置公开的附加结果字段。
error失败错误信息；成功或处理中通常为 null。

查询任务结果

生成任务为异步执行。提交成功后接口会返回任务 id，请携带该 id 轮询下面的查询接口，直到 status 变为 completed（成功）或 failed（失败）。
http
GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{id}
Authorization: Bearer <API_KEY>
idstring必填
提交任务接口返回的任务 ID。
当 status 为 completed 时，结果地址通过 result_url 与 video_url 返回；其余字段含义见上方“返回约定”。
建议轮询间隔 5–10 秒，status 为 completed 或 failed 时应停止轮询。结果地址存在有效期，请及时下载转存。