HappyHorse 1.0 - Text to Video

接口提示

happyhorse_1.0_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.0_t2v

---

input object 必填

生成请求的输入参数

prompt string 必填

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

示例：A cinematic shot of a white horse running across a misty grassland at sunrise

---

parameters object

生成参数

resolution string

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

可选值: 720P, 1080P

默认值: 1080P

ratio string

输出视频画幅比例

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

默认值: 16:9

duration integer

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

范围: 3 - 15

默认值: 5

watermark boolean

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

可选值: true, false

默认值: true

seed integer

随机种子. 如果不指定, 系统会自动生成随机种子. 如需提升复现性, 可在重复调用时使用相同 seed 值

范围: 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

元数据信息