HappyHorse 1.0 - First Frame Image to Video

接口提示

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

happyhorse_1.0_i2v 不支持 ratio, 输出视频画幅比例跟随首帧图像

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: happyhorse_1.0_i2v

---

input object 必填

生成请求的输入参数

prompt string

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

示例：The horse starts running forward through the field

media array 必填

输入媒体数组. 需要且仅能提供一张首帧图像

type string 必填

媒体类型

值: first_frame

url string 必填

首帧图像 URL 或 Base64 编码图像数据

图像要求：
支持格式：JPEG, JPG, PNG, WEBP
宽高：均不小于 300 像素
宽高比：1:2.5 到 2.5:1
文件大小：最大 20MB

输入格式：
可公网访问的 HTTP 或 HTTPS URL
Base64 格式：data:{MIME_type};base64,{base64_data}
MIME 类型：JPEG/JPG 为 image/jpeg, PNG 为 image/png, WEBP 为 image/webp

示例：https://example.com/first-frame.jpg

---

parameters object

生成参数

resolution string

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

可选值: 720P, 1080P

默认值: 1080P

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

元数据信息