Model Centermingyan

seedance_1_5_pro_480p

POST/kyyReactApiServer/v2/model-center/tasks

模型信息

字段
模型 ID(modelseedance_1_5_pro_480p
模型类型视频模型
请求时 model 字段必须填写上表中的“模型 ID”,填写“模型名称”会导致找不到模型。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer <API_KEY>

请求参数

以下参数放在请求体(JSON)中提交。model 为必填,取值请使用上方“模型信息”中的模型 ID。
promptstring必填
提示词
文本提示词输入。
最小值:1
durationinteger
时长
视频生成时长。
取值范围:4 – 11
sizestring
尺寸
输出尺寸或像素规格。
可选值:16:94:31:13:49:1621:9keep_ratioadaptive
first_imageimage[]
首帧图
图生视频首帧输入。
取值范围:0 – 1
数量:0 - 1
支持传入公开可访问的资源在线 URL。
last_imageimage[]
尾帧图
视频尾帧约束输入。
取值范围:0 – 1
数量:0 - 1
支持传入公开可访问的资源在线 URL。

返回约定

任务状态统一为 queuedprocessingcompletedfailed。查询结果只有在 statuscompleted 时返回结果 URL;
字段说明
id任务 ID,用于查询任务状态和结果。
object资源类型,当前模型通常为 video
created任务创建时间,Unix 秒级时间戳。
model本次调用的模型名称。
statusqueuedprocessingcompletedfailed
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。
statuscompleted 时,结果地址通过 result_urlvideo_url 返回;其余字段含义见上方“返回约定”。
建议轮询间隔 5–10 秒,statuscompletedfailed 时应停止轮询。结果地址存在有效期,请及时下载转存。