HappyHorse 1.0 - Video Edit

接口提示

happyhorse-1.0-video-edit 生成的视频格式为 MP4, 帧率为 24fps, 支持 720P 和 1080P 分辨率, 时长为 3 到 15 秒

happyhorse-1.0-video-edit 在输入视频不超过 15 秒时使用原输入时长, 输入视频超过 15 秒时截取前 15 秒

happyhorse-1.0-video-edit 按输入视频和输出视频秒数共同计费, resolution 会影响单价

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: happyhorse-1.0-video-edit

---

input object 必填

生成请求的输入参数

prompt string 必填

文本提示词, 用于描述如何编辑输入视频. 支持中文和英文. 每个中文字符或字母计为一个字符. 超过 2500 个字符的内容会被自动截断

示例：Turn the scene into a warm watercolor animation while keeping the main subject motion unchanged

media array 必填

输入媒体数组. 需要且仅能提供一个输入视频, 可提供 0 到 5 张参考图像

type string 必填

媒体类型

可选值: video, reference_image

url string 必填

媒体 URL

视频要求：
可公网访问的 HTTP 或 HTTPS URL
支持格式：MP4, MOV
编码建议：H.264
时长：3 - 60 秒
短边：不小于 360 像素
宽高比：1:8 到 8:1
文件大小：最大 100MB
帧率：大于 8fps

参考图像要求：
可公网访问的 HTTP 或 HTTPS URL
支持格式：JPEG, JPG, PNG, BMP, WEBP
宽高：均不小于 300 像素
宽高比：1:2.5 到 2.5:1
文件大小：最大 10MB

示例：https://example.com/input-video.mp4

---

parameters object

生成参数

resolution string

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

可选值: 720P, 1080P

默认值: 1080P

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

元数据信息