HappyHorse Video
HappyHorse video generation and editing services support text-to-video, first-frame image-to-video, reference image-to-video, and video editing.
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.
覆盖视频生产的关键动作
无需在多个供应商接口之间拼接流程,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` 主动查询或等待回调。
失败任务会收费吗?
不会。只有成功完成并记录结果的任务会按时长和分辨率计费。
相关视频能力
如果你需要不同模型生态或更细分的视频能力,可以搭配这些公开服务。
Packages
We offer various credit packages. The more you purchase, the higher the discount you receive.
