SuperAPI AI 工具集

aliyun-happyhorse-videoedit

设计与创作

查看项目

更新于 10-15 17:34

技能介绍

用途:调用 DashScope 的 HappyHorse 1.0 视频编辑模型(固定模型名 happyhorse-1.0-video-edit),以文本指令对已有视频进行编辑。仅做编辑,不用于从零生成视频。

主要能力:一是风格迁移,通过文本指令把输入视频转换为另一种视觉风格,需要恰好 1 段视频;二是指令式局部替换/修改,用提示词配合 0-5 张参考图片替换或修改画面主体,需要 1 段视频加 0-5 张 reference_image。

使用方式:先准备环境,安装依赖(建议虚拟环境):python3 -m venv .venv、. .venv/bin/activate、python -m pip install requests;设置 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。调用端点为 POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis,必须带 Authorization: Bearer $DASHSCOPE_API_KEY、Content-Type: application/json、X-DashScope-Async: enable 头;新加坡区域把域名换成 dashscope-intl.aliyuncs.com。该接口仅支持异步,创建任务后轮询 GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id},建议间隔 15 秒。请求参数含 model(必填,固定为 happyhorse-1.0-video-edit)、input.prompt(必填,非中日韩字符最多 5000、中日韩字符最多 2500)、input.media(必填,1 个 video 加 0-5 个 reference_image,均为公网 URL),以及 resolution(720P 或 1080P,默认 1080P)、audio_setting(auto 默认或 origin 保留原音)、watermark(默认 true,右下角 Happy Horse 水印)、seed(0 至 2147483647)。

输入限制:视频支持 MP4、MOV,建议 H.264,时长 3-60 秒,输出上限 15 秒,超过 15 秒截取前 15 秒;长边不超过 2160 像素、短边不小于 320 像素,宽高比 1:2.5 至 2.5:1,帧率大于 8 fps,最大 100 MB。参考图支持 JPEG、JPG、PNG、WEBP,宽高均不小于 300 像素,宽高比 1:2.5 至 2.5:1,最大 10 MB。输出为 H.264 MP4,video_url 与 task_id 均 24 小时有效,需及时下载保存;建议把任务 ID、轮询响应和最终视频地址保存在 output/aliyun-happyhorse-videoedit/ 下。

适用场景:已有素材的整段风格化改造,或在指令和参考图引导下替换画面元素。

限制与注意:不要使用其他模型 ID;不要同步调用;不要传多段视频、超过 5 张参考图,或 first_frame、last_frame、driving_audio;不要传 ratio 或 duration,输出比例跟随输入、时长遵循截断规则。常见错误包括 401(密钥缺失或无效)、400 InvalidParameter(分辨率、参考图数量或媒体超限)、缺少异步头导致的同步调用报错、task_status 为 UNKNOWN(task_id 超过 24 小时)以及 429(超过配额,可退避重试,查询 RPS 默认 20)。

其它事项:官方文档与来源信息暂未提供更多计费、价格细节。