HappyHorse-视频编辑

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

生成任务的输入参数

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成任务的模型名称。必填字段。 - 该接口必须使用 happyhorse/video-edit 模型 默认值："happyhorse/video-edit"。 可选值：happyhorse/video-edit。 示例：happyhorse/video-edit。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。视频编辑指令，用自然语言描述“要怎么改”。 maxLength: 2000. 示例：让视频中的马头人身角色穿上图片中的条纹毛衣。
video_url	string	是	待编辑的视频 URL（必须且只能 1 个）。 视频限制： 格式：MP4、MOV（建议H.264编码）。 时长：3-60秒。 分辨率：长边不超过2160像素，短边不小于320像素。 宽高比：1:2.5~2.5:1。 文件大小：不超过100MB。 帧率：大于8fps。
reference_image	array<string>	否	可选参考图片 URL（用于风格/局部替换参考）。 图像限制： 格式：JPEG、JPG、PNG、WEBP。 分辨率：宽高尺寸不小于300像素。 宽高比：1:2.5~2.5:1。 文件大小：不超过10MB。 minItems: 0. maxItems: 5.
resolution	string	否	输出视频分辨率。 默认值："1080p"。 可选值：720p / 1080p。 示例：1080p。
audio_setting	string	否	音频处理策略：auto 表示由模型自动处理；origin 表示尽量保留原视频音频。 默认值："auto"。 可选值：auto / origin。 示例：auto。
seed	integer	否	随机种子。 minimum: 0. maximum: 2147483647.

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/video-edit",
  "prompt": "让视频中的马头人身角色穿上图片中的条纹毛衣",
  "video_url": "https://example.com/reference.mp4",
  "resolution": "1080p",
  "audio_setting": "auto"
}'

{
  "model": "happyhorse/video-edit",
  "prompt": "让视频中的马头人身角色穿上图片中的条纹毛衣",
  "video_url": "https://example.com/reference.mp4",
  "resolution": "1080p",
  "audio_setting": "auto"
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}