HappyHorse-视频编辑

POST /api/v1/services/aigc/video-generation/video-synthesis — 输入视频与参考图，按文本指令编辑

HappyHorse 视频编辑模型：输入一段视频与可选参考图，结合文本指令完成风格变换、局部替换等编辑任务。

支持的模型

模型	说明
`happyhorse-1.0-video-edit`	视频编辑
`happyhorse-1.0-video-edit-20260618`	视频编辑 · 20260618 快照版本

创建任务

POST/api/v1/services/aigc/video-generation/video-synthesis

curl https://api.modelsite.ai/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Authorization: Bearer $MODELSITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "input": {
      "prompt": "让视频中的角色穿上参考图中的条纹毛衣",
      "media": [
        { "type": "video", "url": "https://example.com/input.mp4" },
        { "type": "reference_image", "url": "https://example.com/sweater.webp" }
      ]
    },
    "parameters": { "resolution": "720P" }
  }'

请求体

字段	类型	说明
`model`	string（必填）	固定为 `happyhorse-1.0-video-edit`
`input.prompt`	string（必填）	编辑意图描述（风格转换、局部替换等）。中文字符按 2 计、其他按 1 计，总预算 5000
`input.media`	array（必填）	1 个 `video` 元素（必传）+ 0~5 个 `reference_image` 元素（可选）
`parameters`	object（可选）	见下表

parameters 参数

参数	类型	说明
`resolution`	string	`720P` / `1080P`（默认）。可售档位以价格配置为准
`watermark`	boolean	默认 `true`（"Happy Horse" 角标），不想要须显式传 `false`
`audio_setting`	string	声音控制：`auto`（默认，模型自决）/ `origin`（保留原视频声音）
`seed`	integer	`[0, 2147483647]`

素材要求

待编辑视频：MP4 / MOV（建议 H.264），时长 3~~60 秒，短边 ≥360px、长边 ≤4096px，宽高比 1:2.5~~2.5:1，≤100MB，帧率 8-60fps
参考图：JPEG / JPG / PNG / WEBP，宽高 ≥300px，宽高比 1:2.5~2.5:1，≤20MB

输出视频时长为 3~15 秒：输入不超过 15 秒时输出时长与输入一致；超过 15 秒时取前 15 秒作为有效片段。

轮询与结果

GET/api/v1/tasks/{task_id}

curl "https://api.modelsite.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

响应字段

字段	说明
`output.task_id`	任务 ID（与创建时返回的一致）
`output.task_status`	`PENDING` 排队 / `RUNNING` 处理中 / `SUCCEEDED` 成功 / `FAILED` 失败
`output.video_url`	生成视频的 URL，仅 `SUCCEEDED` 时返回，尽快下载转存
`output.code` / `output.message`	仅失败时返回，失败原因
`usage`	用量统计（时长、分辨率档位等），仅成功时计数
`request_id`	请求唯一标识，排查问题时请提供

状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

计费

按实际生成时长（秒，浮点）计费；任务失败不计费。单价见模型页。

错误处理

创建阶段错误返回 {"code": "...", "message": "..."}；任务内失败看轮询的 output.code / output.message。通用错误码见错误处理。

HappyHorse-视频编辑

支持的模型

创建任务

轮询与结果

计费

错误处理

本页内容