mingyanmingyan
mingyan

Happy Horse 首帧图生视频 - 创建任务

创建 Happy Horse 首帧图生视频任务,模型固定为 happyhorse-1.0-i2v

POST/kyyReactApiServer/v1/happyhorse-i2v/videos

Happy Horse 首帧图生视频创建任务

使用 happyhorse-1.0-i2v 创建首帧图生视频任务。该接口通过首帧图片和提示词生成视频,画面比例跟随首帧图片,不接收 ratio 参数。

认证

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

基础 URL

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

请求参数

modelbodystring必填
模型名称,固定为 happyhorse-1.0-i2v
promptbodystring必填
视频生成提示词,最长 2500 个中文字符或 5000 个非中文字符。
first_imagebodystring必填
首帧图片公网 URL,仅支持 HTTP / HTTPS,暂不支持 Base64。
图像限制:
  • 格式:JPEGJPGPNGWEBP
  • 分辨率:宽和高不小于 300 像素
  • 宽高比:1:2.52.5:1
  • 文件大小:不超过 20MB
durationbodyinteger
视频时长,单位秒,默认 5,范围 3-15
resolutionbodystring
输出分辨率,默认 720P,可选值为 720P1080P
seedbodyinteger
随机种子,范围 0-2147483647,默认 0

响应参数

idstring
视频生成任务的唯一标识符,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
创建任务时使用的模型名称。
statusstring
任务状态。创建成功时固定返回 queued
errorstring
错误信息。创建成功时通常为 null
关键约束:
  • model 必须为 happyhorse-1.0-i2v
  • first_image 必须是公网 URL,当前不支持 Base64
  • 图生视频比例跟随首帧图片,不支持传入 ratio
  • resolution 默认 720P