视频编辑

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

官方创建任务路径：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

OneLinkAI 路径：POST /happyhorse/v1/services/aigc/video-generation/video-synthesis

官方查询任务路径：GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

OneLinkAI 路径：GET /happyhorse/v1/tasks/{task_id}

视频编辑任务耗时较长（通常为 1~5 分钟），API 采用异步调用方式，整体流程为：创建任务 → 轮询查询。

创建视频编辑任务

请求

请求头

字段	类型	必选	说明
`Content-Type`	string	是	固定值 `application/json`
`Authorization`	string	是	Bearer Token 鉴权，格式：`Bearer <ApiKey>`
`X-DashScope-Async`	string	是	异步处理标识，必须设置为 `enable`。缺少此请求头将报错

请求体

model string 必选

模型名称。固定值：happyhorse-1.0-video-edit

input object 必选

输入的基本信息，包括待编辑的视频、参考图片和提示词。

属性：

input.prompt string 必选

文本提示词，描述对视频的编辑意图，如风格转换、局部替换等。支持任意语言，长度不超过 5000 个非中文字符或 2500 个中文字符，超出部分自动截断。

input.media array 必选

媒体素材列表。必须包含 1 个 video 类型元素；可选包含 0~5 个 reference_image 类型元素。

media[] 元素属性：

input.media[].type string 必选

媒体素材类型。可选值：

video：必传，待编辑的视频，有且仅有 1 个

reference_image：可选，参考图像，0~5 张

input.media[].url string 必选

媒体素材 URL 或 Base64 编码数据。

传入视频（type=video）：

格式：MP4、MOV（建议 H.264 编码）

时长：3~60 秒

分辨率：长边不超过 2160 像素，短边不小于 320 像素

宽高比：1:2.5 ~ 2.5:1

文件大小：不超过 100 MB

帧率：大于 8fps

必须为公网可访问的 URL（HTTP 或 HTTPS）

说明：输出视频时长为 3~15 秒。输入视频不超过 15 秒时，输出时长与输入一致；超过 15 秒时，自动截取前 15 秒。

传入图像（type=reference_image）：

格式：JPEG、JPG、PNG、WEBP

分辨率：宽高尺寸不小于 300 像素

宽高比：1:2.5 ~ 2.5:1

文件大小：不超过 20 MB

支持公网 URL 或 Base64 编码：data:{MIME_type};base64,{base64_data}

parameters object 可选

视频编辑参数。

属性：

parameters.resolution string 可选

生成视频的分辨率档位。

可选值：

1080P（默认值）

720P

parameters.watermark boolean 可选

是否在生成视频上添加水印（位于右下角，文案固定为"Happy Horse"）。

true（默认值）：添加水印

false：不添加水印

parameters.audio_setting string 可选

声音控制。

auto（默认值）：由模型自行控制

origin：保留输入视频的原始声音

parameters.seed integer 可选

随机数种子，取值范围 [0, 2147483647]。未指定时系统自动生成。固定 seed 可提升结果可复现性，但不保证完全一致。

请求示例

响应

成功响应

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

异常响应

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

响应字段说明

字段	类型	说明
`output.task_id`	string	任务 ID，查询有效期 24 小时
`output.task_status`	string	任务状态，见下方枚举值
`request_id`	string	请求唯一标识，可用于问题排查
`code`	string	错误码，请求成功时不返回
`message`	string	错误详情，请求成功时不返回

task_status 枚举值：

值	说明
`PENDING`	任务排队中
`RUNNING`	任务处理中
`SUCCEEDED`	任务执行成功
`FAILED`	任务执行失败
`CANCELED`	任务已取消
`UNKNOWN`	任务不存在或状态未知

查询视频编辑任务

请求

请求头

字段	类型	必选	说明
`Authorization`	string	是	Bearer Token 鉴权，格式：`Bearer <ApiKey>`

URL 路径参数

字段	类型	必选	说明
`task_id`	string	是	创建任务时返回的任务 ID

请求示例

响应

任务执行成功

视频 URL 仅保留 24 小时，超时后自动清除，请及时保存。

{
  "request_id": "c11018a8-3f83-9591-a636-xxxxxx",
  "output": {
    "task_id": "051c7b40-b2c5-4341-aee4-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-26 14:13:14.373",
    "scheduled_time": "2026-04-26 14:13:14.419",
    "end_time": "2026-04-26 14:14:13.679",
    "orig_prompt": "让视频中的马头人身角色穿上图片中的条纹毛衣",
    "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxxx.mp4"
  },
  "usage": {
    "duration": 13.24,
    "input_video_duration": 6.62,
    "output_video_duration": 6.62,
    "video_count": 1,
    "SR": 720
  }
}

任务执行失败

{
  "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
  "output": {
    "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The resolution is not valid xxxxxx"
  }
}

任务查询过期

{
  "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
  "output": {
    "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
    "task_status": "UNKNOWN"
  }
}

响应字段说明

字段	类型	说明
`output.task_id`	string	任务 ID
`output.task_status`	string	任务状态，枚举值同上
`output.submit_time`	string	任务提交时间，格式 `YYYY-MM-DD HH:mm:ss.SSS`
`output.scheduled_time`	string	任务开始执行时间
`output.end_time`	string	任务完成时间
`output.video_url`	string	视频 URL，仅 SUCCEEDED 时返回，有效期 24 小时，MP4 格式（H.264）
`output.orig_prompt`	string	原始输入的 prompt
`output.code`	string	错误码，失败时返回
`output.message`	string	错误详情，失败时返回
`usage.duration`	float	总视频时长（秒），用于计费（输入+输出）
`usage.input_video_duration`	float	输入视频时长（秒）
`usage.output_video_duration`	float	输出视频时长（秒）
`usage.video_count`	integer	输出视频数量，固定为 1
`usage.SR`	integer	输出视频分辨率档位
`request_id`	string	请求唯一标识

使用建议

视频编辑过程约需 1~5 分钟，建议采用轮询机制，查询间隔设置为 15 秒左右。

任务状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。

任务成功后请立即下载视频或转存至永久存储，视频链接有效期仅 24 小时。

task_id 有效期为 24 小时，超时后无法查询，接口将返回 UNKNOWN 状态。

请勿重复创建相同任务，获取 task_id 后轮询查询即可。

HappyHorse 视频编辑

视频编辑#

创建视频编辑任务#

请求#

请求示例#

响应#

查询视频编辑任务#

请求#

请求示例#

响应#

使用建议#

视频编辑

创建视频编辑任务

请求

请求示例

响应

查询视频编辑任务

请求

请求示例

响应

使用建议