mingyanmingyan
mingyan

Happy Horse 文生视频 - 创建任务

创建 Happy Horse 文生视频任务,模型固定为 happyhorse-1.0-t2v

POST/kyyReactApiServer/v1/happyhorse-t2v/videos

Happy Horse 文生视频创建任务

使用 happyhorse-1.0-t2v 创建文生视频任务。该接口根据提示词生成视频,默认输出 720P5 秒、16:9

认证

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

基础 URL

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

请求参数

modelbodystring必填
模型名称,固定为 happyhorse-1.0-t2v
promptbodystring必填
视频生成提示词,最长 2500 个中文字符或 5000 个非中文字符。
示例:"一只猫在草地上奔跑"
durationbodyinteger
视频时长,单位秒。
  • 默认值:5
  • 支持范围:3-15
ratiobodystring
输出比例。
  • 默认值:16:9
  • 可选值:16:99:161:14:33:44:55:49:2121:9
resolutionbodystring
输出分辨率。
  • 默认值:720P
  • 可选值:720P1080P
seedbodyinteger
随机种子,范围 0-2147483647,默认 0。固定 seed 有助于提升生成结果的可复现性,但不保证每次完全一致。

响应参数

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