mingyanmingyan
mingyan

Happy Horse 参考生视频 - 创建任务

创建 Happy Horse 参考生视频任务,模型固定为 happyhorse-1.0-r2v

POST/kyyReactApiServer/v1/happyhorse-r2v/videos

Happy Horse 参考生视频创建任务

使用 happyhorse-1.0-r2v 创建参考生视频任务。该接口通过 referenceImages 传入参考图片,并可在 prompt 中使用 [Image 1][Image 2] 指代对应图片。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelbodystring必填
模型名称,固定为 happyhorse-1.0-r2v
promptbodystring必填
视频生成提示词,最长 2500 个中文字符或 5000 个非中文字符。
示例:"使用 [Image 1] 作为主体生成视频"
referenceImagesbodyarray必填
参考图片 URL 列表,支持 1-9 张。
图片限制:
  • 格式:JPEGJPGPNGWEBP
  • 推荐 720P 以上清晰图
  • 短边不低于 400 像素
  • 文件大小:不超过 20MB
durationbodyinteger
视频时长,单位秒,默认 5,范围 3-15
ratiobodystring
输出比例,默认 16:9
可选值:16:99:161:14:33:44:55:49:2121:9
resolutionbodystring
输出分辨率,默认 720P,可选值为 720P1080P
seedbodyinteger
随机种子,范围 0-2147483647,默认 0

响应参数

idstring
视频生成任务的唯一标识符,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
创建任务时使用的模型名称。
statusstring
任务状态。创建成功时固定返回 queued
errorstring
错误信息。创建成功时通常为 null
关键约束:
  • model 必须为 happyhorse-1.0-r2v
  • referenceImages 必填,最多 9
  • duration 默认 5 秒,范围 3-15
  • resolution 默认 720P