覆盖视频生产的关键动作
无需在多个供应商接口之间拼接流程，HappyHorse 把常见视频生成与编辑模式收敛为统一请求结构。
文生视频
输入镜头语言、场景和动作，快速生成短视频原型。
首帧图生视频
用固定首帧控制构图，让静态视觉素材自然动起来。
参考图生视频
通过多张参考图约束角色、道具、风格和画面元素。
视频编辑
基于输入视频和参考图做风格迁移、换装、局部替换。
curl -X POST 'https://api.acedata.cloud/happyhorse/videos' \
-H 'authorization: Bearer YOUR_API_KEY' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"action": "image_to_video",
"model": "happyhorse-1.1-i2v",
"image_url": "https://cdn.acedata.cloud/b1c82e4937.png",
"prompt": "A cinematic white horse lifts its head, the mane moves gently in the sunrise wind, slow camera push in, warm film lighting",
"resolution": "720P",
"duration": 5,
"async": true
}'一个请求提交视频任务
使用 async 立即返回任务 ID，再通过 `/happyhorse/tasks` 查询结果；如果传入 `callback_url`，任务完成后会把最终结果推送到你的服务。
选择 action
文生视频、图生视频、参考图或编辑都用同一个入口。
传入素材
图片和视频必须是公网可访问 URL，建议使用 Ace Data Cloud CDN。
查询结果
根据 task_id 获取最终 CDN 视频 URL、时长和分辨率。
适合接入真实产品的三类场景
从营销素材到内容工具，HappyHorse 更适合作为稳定的视频能力模块，而不是一次性玩具。
品牌短片原型
用文本和首帧快速生成商品、角色、场景短片，验证视觉方向。
角色与道具一致性
通过多张参考图锁定角色、服装、道具和视觉风格。
视频后期编辑
在已有片段上做风格迁移、局部替换和音频保留策略。
三步上线视频能力
沿用 Ace Data Cloud 统一鉴权、计费、任务和回调模式，接入路径清晰可控。
申请 Token
在控制台创建应用，获取统一 Bearer Token。
提交任务
按 action 传入 prompt、image_url、image_urls 或 video_url。
拉取结果
通过任务 API 或回调拿到可下载的 CDN 视频 URL。
为什么用统一 API
把模型调用、任务轮询、CDN 转存、错误分类和计费记录都收敛在平台侧。
| 能力 | Ace Data Cloud HappyHorse | Some Others |
|---|---|---|
| 多种视频 action | 统一 `/happyhorse/videos` | 多个接口自行拼接 |
| 结果文件 | 自动转存 CDN | 常见临时 URL 过期 |
| 计费 | 按实际秒数记录 | 需要自建用量账本 |
| 失败处理 | 结构化错误码 | 上游错误格式不稳定 |
按任务选择模型
1.1 模型优先用于生成任务；视频编辑当前使用 1.0 video-edit。
happyhorse-1.1-t2v
默认文生视频模型，适合从脚本和镜头描述生成短片。
happyhorse-1.1-i2v
以首帧图片控制构图和视觉基调，适合商品图、角色图动效化。
happyhorse-1.1-r2v
通过多张参考图约束角色与道具，适合一致性要求更高的场景。
happyhorse-1.0-video-edit
基于输入视频进行编辑，并可选择保留原始音频。
常见问题
上线前最容易关心的参数、素材和计费问题。
HappyHorse 支持哪些输入素材？
文生视频只需要 prompt；首帧图生视频需要 image_url；参考图生视频需要 1–9 张 image_urls；视频编辑需要 video_url，并可选 0–5 张参考图。
返回的视频 URL 会过期吗？
Ace Data Cloud 会把上游结果转存到平台 CDN，文档和 API 响应中使用的是可访问的 CDN URL。
如何处理长时间生成？
建议使用 async 或 callback_url。接口会先返回 task_id，你可以通过 `/happyhorse/tasks` 主动查询或等待回调。
失败任务会收费吗？
不会。只有成功完成并记录结果的任务会按时长和分辨率计费。
相关视频能力
如果你需要不同模型生态或更细分的视频能力，可以搭配这些公开服务。