Model Center小七claw

seedance_2.5_o1

POST/kyyReactApiServer/v2/model-center/tasks

模型信息

字段	值
模型 ID（`model`）	`seedance_2.5_o1`
模型类型	视频模型
请求时 `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

时长

视频生成时长。

可选值：5、6、7、8、9、10、11、12、13、14、15、16、17、18、19、20、21、22、23、24、25、26、27、28、29、30

默认值：8

aspect_ratiostring

画幅比例

输出画幅比例。

可选值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive

默认值：16:9

resolutionstring必填

分辨率

输出分辨率档位。

可选值：720p、1080p

默认值：720p

seedinteger

随机种子

可复现生成的随机种子。

first_imageimage[]

首帧图

图生视频首帧输入。

取值范围：0 – 1

数量：0 - 1

支持传入公开可访问的资源在线 URL。

last_imageimage[]

尾帧图

视频尾帧约束输入。

取值范围：0 – 1

数量：0 - 1

支持传入公开可访问的资源在线 URL。

audio_settingstring

音频策略

视频编辑或生成的音频处理策略。

generate_audioboolean

生成音频

是否生成视频音频轨。

默认值：false

requires_reference_videostring

watermarkboolean

水印

是否添加上游或平台水印。

默认值：true

返回约定

任务状态统一为 queued、processing、completed、failed。查询结果只有在 status 为 completed 时返回结果 URL；

字段	说明
`id`	任务 ID，用于查询任务状态和结果。
`object`	资源类型，当前模型通常为 `video`。
`created`	任务创建时间，Unix 秒级时间戳。
`model`	本次调用的模型名称。
`status`	`queued`、`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 时应停止轮询。结果地址存在有效期，请及时下载转存。