mingyanmingyan
微信微信
登录
Model Centermingyan

sd_2.0_fast_special

POST/kyyReactApiServer/v2/model-center/tasks

素材库

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

模型信息

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

认证

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

请求参数

以下参数放在请求体（JSON）中提交。model 为必填，取值请使用上方“模型信息”中的模型 ID。
promptstring必填
提示词
文本提示词输入。
最小值：1
reference_imagesimage[]
参考图
参考图
取值范围：0 – 9
数量：0 - 9
支持传入公开可访问的资源在线 URL。
reference_videosvideo[]
参考视频
参考视频输入。
取值范围：0 – 3
数量：0 - 3
支持传入公开可访问的资源在线 URL。
reference_audiosaudio[]
参考音频
参考音频输入。
取值范围：0 – 3
数量：0 - 3
支持传入公开可访问的资源在线 URL。
durationinteger必填
时长
视频生成时长。
取值范围：4 – 15
默认值：5
aspect_ratiostring
画幅比例
输出画幅比例。
可选值：16:9、9:16、1:1、3:4、4:3、21:9、adaptive
默认值：16:9
resolutionstring
分辨率
输出分辨率档位。
可选值：720p
默认值：720p
seedinteger
随机种子
可复现生成的随机种子。
默认值：-1
first_imageimage[]
首帧图
图生视频首帧输入。
取值范围：0 – 1
数量：0 - 1
支持传入公开可访问的资源在线 URL。
last_imageimage[]
尾帧图
视频尾帧约束输入。
取值范围：0 – 1
数量：0 - 1
支持传入公开可访问的资源在线 URL。
generate_audioboolean
生成音频
是否生成视频音频轨。
默认值：true
toolsarray
提示词
官方工具配置
watermarkboolean
水印
是否添加上游或平台水印。
默认值：false

素材与场景限制

  • 文本提示词：中文建议不超过 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失败错误信息；成功或处理中通常为 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 时应停止轮询。结果地址存在有效期，请及时下载转存。