HappyHorse 1.0 API

Alibaba HappyHorse 1.0，支持通过文本、首帧或参考图生成 720p 或 1080p 视频。

已预热官方实时按路由定价数据隐私零数据训练 API 文档

输入

prompt*string

描述主体、动作、镜头、光影及节奏

route_modestring

选择用于此请求的提供商路由。

成本更低的官方路由，也是新请求和 API 密钥的默认选项。

generation_typestring

选择生成工作流。API 模式将随此选项更新。

aspect_ratiostring

生成内容的宽高比

默认："16:9"

resolutionstring

分辨率越高，生成所需时间可能越长。

默认："720p"

durationnumber

生成视频的时长（秒）

输出

准备就绪，可开始推理调整输入参数，然后运行模型。

快速开始

视频 API 参考

创建 API 密钥
在控制台中创建密钥并将其保存为 MLMUX_API_KEY 环境变量。
创建 API 密钥
发送请求
使用模型 ID alibaba/happyhorse-1.0 向 https://api.mlmux.com/v1/videos/generations 发送请求。该示例使用了此页面的默认设置；可根据需要修改提示词和选项。
读取结果
响应为一个任务。每隔几秒轮询其 poll_url，直到 status 为 succeeded，然后下载视频；也可以配置 webhook 接收通知。

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/happyhorse-1.0",
  "route_mode": "official-cheap",
  "prompt": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
  -H "Authorization: Bearer $MLMUX_API_KEY"

示例

查看更多示例 ↗

价格方案

视频按所选分辨率的输出时长（秒）计费。价格因分辨率和路由而异。

了解有关价格的更多信息 ↗

所有视频费率

按输出视频每秒计费（按分辨率区分）。计费依据提供商报告的秒数。

分辨率	official	official-cheap
720p	$0.138 / 秒	$0.125 / 秒
1080p	$0.246 / 秒	$0.222 / 秒

自述文档

HappyHorse 1.0 已接入 MLMux，提供统一的请求结构及两个明确的路由层级。

三种生成方式

输入提示词、让起始图像动起来，或使用参考图引导片段生成。

720p 或 1080p

片段时长 3 到 15 秒，分辨率为 720p 或 1080p。

选择 HappyHorse 模型

HappyHorse 1.1 新增了 480p 选项且 1080p 价格更低；HappyHorse 1.0 Video Edit 用于编辑现有视频。

常见问题

HappyHorse 1.0 是什么？

HappyHorse 1.0 是 Alibaba 推出的视频生成模型。在 MLMux 上，你可以直接在浏览器中运行它，也可以通过一个 API 调用。Alibaba HappyHorse 1.0，支持通过文本、首帧或参考图生成 720p 或 1080p 视频。

如何使用 HappyHorse 1.0 API？

在 MLMux 控制台创建 API 密钥，然后向 https://api.mlmux.com/v1/videos/generations 发送 POST 请求，在 Authorization 请求头中携带密钥，并将 model 设为 alibaba/happyhorse-1.0。请求会返回一个任务：你可以轮询它，也可以在视频生成完成时接收 Webhook 通知。