⌘K

HappyHorse 1.0 - Video Edit

happyhorse_1.0_video_edit

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 个字符, 非中文提示词最多支持 5000 个字符. 超出限制的内容会被自动截断

示例：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 秒
长边不超过 4096 像素
短边不少于 360 像素
宽高比: 1:2.5 到 2.5:1
文件大小: 最大 100MB
帧率: 大于 8fps

输出时长:
输出视频为 3 到 15 秒. 输入视频不超过 15 秒时保持原输入时长; 输入视频超过 15 秒时会从开头自动截取前 15 秒.

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

参考图像 Base64 格式:
data:{MIME_type};base64,{base64_data}
MIME 类型: JPEG/JPG image/jpeg, PNG image/png, WEBP image/webp

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

parameters object

生成参数

resolution string

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

可选值: 720P, 1080P

默认值: 1080P

watermark boolean

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

可选值: true, false

默认值: true

audio_setting string

声音控制模式

可选值: auto, origin

默认值: auto

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

元数据信息