HappyHorse 1.0 - Reference to Video

接口提示

happyhorse_1.0_r2v 生成的视频格式为 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_r2v

---

input object 必填

生成请求的输入参数

prompt string 必填

文本提示词, 用于描述生成视频的内容. 支持中文和英文. 使用 [Image 1]、[Image 2] 等占位符引用参考图, 顺序与 media 数组一致. 中文提示词最多支持 2500 个字符, 非中文提示词最多支持 5000 个字符. 超出限制的内容会被自动截断

示例：[Image 1] gallops through a forest while [Image 2] follows behind

media array 必填

参考图像数组. 支持提供 1 到 9 张参考图像

type string 必填

媒体类型

值: reference_image

url string 必填

参考图像 URL 或 Base64 编码图像数据

图像要求：
支持格式：JPEG, JPG, PNG, WEBP
短边：不小于 400 像素
建议分辨率：720P 或更高
文件大小：最大 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/horse-reference.jpg

---

parameters object

生成参数

resolution string

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

可选值: 720P, 1080P

默认值: 1080P

ratio string

输出视频画幅比例

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

默认值: 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

元数据信息