HappyHorse 1.1 - Text to Video

接口提示

happyhorse_1.1_t2v 生成的视频格式为 MP4, 帧率为 24fps, 支持 720P 和 1080P 分辨率, 时长为 3 到 15 秒

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: happyhorse_1.1_t2v

---

input object 必填

生成请求的输入参数

prompt string 必填

文本提示词, 用于描述生成视频的内容. 支持中文和英文. 中文提示词最多支持 2500 个字符, 非中文提示词最多支持 5000 个字符. 超出限制的内容会被自动截断

示例：A miniature city built from cardboard and bottle caps comes to life at night. A cardboard train slowly passes through, with small lights dotting the scene and illuminating the way ahead.

---

parameters object

生成参数

resolution string

视频分辨率. 不同分辨率档位单价不同, 因此该参数会影响计费成本

可选值: 720P, 1080P

默认值: 1080P

ratio string

输出视频画幅比例

可选值: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9

默认值: 16:9

duration integer

视频时长, 单位为秒. 计费按成功生成的输出视频秒数计算, 因此该参数会影响成本

范围: 3 - 15

默认值: 5

watermark boolean

是否在生成视频右下角添加水印. 固定水印文字为 “Happy Horse”

可选值: true, false

默认值: true

seed integer

随机数种子. 未指定时系统会自动生成随机种子. 如需提高生成结果可复现性, 建议固定该值

范围: 0 - 2147483647

---

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息, 仅在状态为 failed 时存在

code string

错误码

message string

详细错误信息

---

output array

生成结果, 仅在状态为 completed 时存在

content array

生成的资源内容列表

type string

资源类型

值: image｜video

url string

处理后的资源 URL

jobId string

远端任务 ID

---

usage object

使用统计, 仅在状态为 completed 时存在

cost string

总费用（美元）

discount number

折扣金额

---

metadata object

元数据信息