HappyHorse 视频编辑

HappyHorse 视频编辑模型，输入视频与参考图，结合文本指令完成风格变换、局部替换等编辑。请求与响应格式与官方接口一致（透传），异步调用：先创建任务获取 task_id，再查询任务获取结果，生成通常需要 1–5 分钟。

备注

本页型号暂未上架，以模型广场为准。

创建任务

POST https://platform.shuyanai.com/ali/api/v1/services/aigc/video-generation/video-synthesis

请求示例

请求头

参数	类型	必填	说明
`Content-Type`	string	是	`application/json`
`Authorization`	string	是	`Bearer sk-xxx`
`X-DashScope-Async`	string	否	异步处理标识。平台会自动补充 `enable`，无需携带，携带也可以

请求体

参数	类型	必填	默认值	说明
`model`	string	是		固定为 `happyhorse-1.0-video-edit`
`input.prompt`	string	是		编辑意图（如风格转换、局部替换）。支持任意语言，不超过 5000 个非中文字符或 2500 个中文字符，超出自动截断
`input.media`	array	是		媒体素材列表：`video` 有且仅有 1 个，`reference_image` 0 ~ 5 张
`input.media[].type`	string	是		`video`（待编辑视频，必传）、`reference_image`（参考图像，可选）
`input.media[].url`	string	是		素材地址。视频仅支持公网 URL（HTTP/HTTPS）；图像支持公网 URL 或 Base64（`data:{MIME_type};base64,{base64_data}`，MIME 为 `image/jpeg`、`image/png`、`image/webp`）
`parameters.resolution`	string	否	`1080P`	分辨率档位：`720P`、`1080P`
`parameters.watermark`	boolean	否	`true`	是否添加水印（视频右下角，文案固定为「Happy Horse」）
`parameters.audio_setting`	string	否	`auto`	声音控制：`auto` 由模型自行控制；`origin` 保留输入视频的原始声音
`parameters.seed`	integer	否	随机	随机数种子，`[0, 2147483647]`。固定 seed 可提升复现性，但不保证完全一致

素材要求：

项目	视频（type=video）	参考图像（type=reference_image）
数量	有且仅有 1 个	0 ~ 5 张
格式	MP4、MOV（建议 H.264 编码）	JPEG、JPG、PNG、WEBP
时长	3 ~ 60 秒	—
分辨率	长边不超过 4096 像素，短边不小于 360 像素	宽高不小于 300 像素
宽高比	1:2.5 ~ 2.5:1	1:2.5 ~ 2.5:1
文件大小	不超过 100 MB	不超过 20 MB
帧率	大于 8fps	—
输入方式	公网 URL	公网 URL 或 Base64

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

响应示例

成功：

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

未提供或提供了无效的 API Key（HTTP 401）：

{
  "error": {
    "code": "",
    "message": "未提供令牌 (request id: xxx)",
    "type": "server_error"
  }
}

字段	类型	说明
`output.task_id`	string	任务 ID，用于查询，有效期 24 小时
`output.task_status`	string	任务状态，见下文「任务状态」
`request_id`	string	请求唯一标识，可用于问题排查
`code` / `message`	string	错误码与详情，仅上游拒绝请求时返回

查询任务

GET https://platform.shuyanai.com/ali/api/v1/tasks/{task_id}

建议每 15 秒查询一次，状态流转为 PENDING → RUNNING → SUCCEEDED / FAILED。

响应示例

成功：

{
  "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://xxx.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"
  }
}

响应字段

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

任务状态

状态	说明
`PENDING`	排队中
`RUNNING`	处理中
`SUCCEEDED`	执行成功
`FAILED`	执行失败
`CANCELED`	已取消
`UNKNOWN`	状态未知（如已超过 24 小时有效期）

完整调用示例（Python）

注意事项

task_id 与视频下载地址有效期均为 24 小时，请及时下载保存。

同一请求只需创建一次任务，通过轮询获取结果，不要重复创建。

错误码

错误	说明
HTTP 401 `未提供令牌` / `无效的令牌`	未提供 API Key 或 API Key 无效
`InvalidParameter`	请求参数不合法
`Throttling`	请求频率超限

HappyHorse-视频编辑

HappyHorse 视频编辑#

创建任务#

请求示例#

请求头#

请求体#

响应示例#

查询任务#

响应示例#

响应字段#

任务状态#

完整调用示例（Python）#

注意事项#

错误码#

HappyHorse 视频编辑

创建任务

请求示例

请求头

请求体

响应示例

查询任务

响应示例

响应字段

任务状态

完整调用示例（Python）

注意事项

错误码