Happy Horse 1.0 API
阿里巴巴 Happy Horse 1.0——电影感 720p / 1080p 视频,运镜流畅、动作富有表现力、提示词保真度高。包含参考生视频,可在多次生成间保持一致的角色/风格身份。
输出 720p(默认)或 1080p。提供文生视频、图生视频、参考生视频(保持参考中的角色、风格和视觉身份)、视频编辑(支持多图参考)和视频延长变体。
概览
关于 Happy Horse 1.0 API
Happy Horse 1.0 能做什么、它在 Alibaba 模型阵容中的定位,以及团队选择它的原因。
Happy Horse 1.0 是 Alibaba 推出的视频生成模型,可通过 WaveSpeedAI REST API 使用。阿里巴巴 Happy Horse 1.0——电影感 720p / 1080p 视频,运镜流畅、动作富有表现力、提示词保真度高。包含参考生视频,可在多次生成间保持一致的角色/风格身份。
输出 720p(默认)或 1080p。提供文生视频、图生视频、参考生视频(保持参考中的角色、风格和视觉身份)、视频编辑(支持多图参考)和视频延长变体。
WaveSpeedAI 上的 Happy Horse 1.0 系列提供 5 个 REST 端点,涵盖 Text-To-Video, Image-To-Video, Video-Extend, Video-To-Video, Reference-To-Video 个工作流。每个变体都有各自的定价、参数选项和示例输出——请选择与你的输入模态和生产约束相匹配的那一个,或使用同一个 API 密钥调用多个变体,组合成多步骤流水线。
使用与 WaveSpeedAI 上其他 1,000 多个 AI 模型相同的 API 密钥、账单账户和速率限制来运行 Happy Horse 1.0。无需单独对接供应商,无需各家 SDK,也无需应对各家不同的速率限制——一次集成即可覆盖从文生图、文生视频到音频合成、3D 生成、放大和编辑的全部能力。
端点
全部 Happy Horse 1.0 API 端点
WaveSpeedAI 现已提供 5 个 Happy Horse 1.0 端点——请选择适合你工作流的变体。
/filters:quality(82)/media/images/1777694993627601247_RvFOYvFP.webp)
Happyhorse 1.0 Text To Video
Alibaba Happy Horse 1.0 (Text-to-Video) generates cinematic 720p / 1080p videos from text prompts with smooth camera movement, expressive motion, and strong prompt fidelity. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694942637773181_JtCLV4is.webp)
Happyhorse 1.0 Image To Video
Alibaba Happy Horse 1.0 (Image-to-Video) animates a reference image into a cinematic 720p / 1080p video, optionally guided by a text prompt. Smooth camera movement and expressive, stable motion. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694354473865969_w1wGOX7i.webp)
Happyhorse 1.0 Video Extend
Alibaba Happy Horse 1.0 (Video Extend) extends existing videos with seamless AI-generated continuation, supporting 720p/1080p output. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694893579905189_ykuDNW6V.webp)
Happyhorse 1.0 Video Edit
Alibaba Happy Horse 1.0 (Video Edit) performs prompt-driven video editing with multi-image reference support, supporting 720p/1080p output. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694912177671305_rTisAKU3.webp)
Happyhorse 1.0 Reference To Video
Alibaba Happy Horse 1.0 (Reference-to-Video) generates new video scenes guided by reference images, maintaining consistent characters, styles, and visual identity. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
示例
看看 Happy Horse 1.0 的实际效果
由 Happy Horse 1.0 API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。
使用方法
如何使用 Happy Horse 1.0 API
从注册到完成一次生成,只需四步。完整的 Python、Node.js 和 cURL 示例见下方的 API 部分。
- 01
获取 API 密钥
注册 WaveSpeedAI 账号,并从控制台复制你的 API 密钥。新账号附带免费体验额度——足够在开始计费前把 Playground 运行几十次。
- 02
提交预测
把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。
- 03
轮询完成状态
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。
- 04
读取输出 URL
状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 Happy Horse 1.0 变体。
应用场景
用 Happy Horse 1.0 可以构建什么
开发者和创作者使用 Happy Horse 1.0 API 的常见工作流。
运镜流畅的文生视频
alibaba/happyhorse-1.0/text-to-video 生成运镜流畅、动作富有表现力的电影感 720p/1080p 片段——目录中的核心定位。提示词保真度高,适合广告和内容流水线工作。
以参考静态图生成视频
alibaba/happyhorse-1.0/image-to-video 把参考图像变成电影感的 720p/1080p 视频,可选配文本提示词引导。运镜流畅,动作富有表现力且稳定。
保持身份的参考生视频
alibaba/happyhorse-1.0/reference-to-video 根据参考图像生成新的视频场景,在整个生成过程中保持一致的角色、风格和视觉身份。身份最重要时应选择的变体。
支持多图参考的视频编辑
alibaba/happyhorse-1.0/video-edit 执行提示词驱动的视频编辑,支持多图参考,输出 720p/1080p。适合对现有片段做针对性编辑。
视频延长,获得更长的片段
alibaba/happyhorse-1.0/video-extend 通过 AI 生成的无缝续写来延长现有视频,输出 720p/1080p。适合用较短的源片段构建更长的序列。
技巧
Happy Horse 1.0 提示词技巧
让 Happy Horse 1.0 输出更好结果的实用建议——总结自生产流水线中各类视频模型都适用的做法。
- 01
身份至关重要的镜头选择参考生视频
alibaba/happyhorse-1.0/reference-to-video 是专用于保持角色、风格和视觉身份一致的变体。适用于同一角色在多次独立生成中必须保持可辨识的系列化内容。
- 02
图生视频保留首帧构图
alibaba/happyhorse-1.0/image-to-video 把参考图像制作成 720p/1080p 片段,可选配文本引导。在加入镜头和主体运动的同时,保留起始静态图的主体和构图。
- 03
明确指定服装和姿势
如果不明确指定服装和姿势,模型会默认倾向于中性的站立姿势。请写明服装和起始姿势,以控制镜头,而不是得到默认结果。
- 04
有意识地选择 720p 或 1080p
目录宣称:电影感 720p / 1080p 输出。720p 为默认;交付分辨率重要时选择 1080p。
- 05
用多图参考的视频编辑做风格重绘
alibaba/happyhorse-1.0/video-edit 对现有视频执行提示词驱动的编辑,支持多图参考。适合在保留源片段运动和构图的同时重绘风格。
定价
Happy Horse 1.0 API 定价
按输出计费。最终费用会随你在各变体 Playground 中设置的参数(分辨率、时长、输出数量、参考素材)而变化。
| 端点 | 类型 | 起步价 |
|---|---|---|
| alibaba/ | text-to-video | $0.70 |
| alibaba/ | image-to-video | $0.70 |
| alibaba/ | video-extend | $0.70 |
| alibaba/ | video-to-video | $0.70 |
| alibaba/ | reference-to-video | $0.70 |
API
调用 Happy Horse 1.0 API
在 wavespeed.ai/accesskey 注册并获取 API 密钥,然后通过 REST 提交预测。Playground 可以为任意输入组合生成可直接粘贴的示例代码。
POSThttps://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)对比
Happy Horse 1.0 与其他方案对比
在 WaveSpeedAI 上,何时应选择 Happy Horse 1.0 而不是同类模型。
Happy Horse 1.0 对比 Seedance 2.0
Seedance 2.0 每个变体都带原生音频,有 Turbo 档位,提供视频编辑/视频延长。Happy Horse 更贵,但提供支持多图参考的参考生视频和视频编辑,Seedance 对此的处理方式不同。
Happy Horse 1.0 对比 Kling 3.0
Kling 3.0 涵盖 Standard、Pro 和 4K 档位以及运动控制。Happy Horse 介于 Kling Pro 和 4K 之间,提供参考生视频和支持多图参考的视频编辑。
Happy Horse 1.0 对比 Wan 2.7
Wan 2.7 涵盖类似的变体(文生视频、图生视频、参考生视频、视频编辑、视频延长),同系列中还有图像编辑和文生图。更便宜、覆盖更广;Happy Horse 则定位于「流畅的运镜」和富有表现力的动作。
常见问题
Happy Horse 1.0 API — 常见问题
定价、许可、集成——关于在 WaveSpeedAI 上运行 Happy Horse 1.0 的常见问题。
Happy Horse 1.0 API 是什么?
Happy Horse 1.0 是 Alibaba 的视频生成模型,在 WaveSpeedAI 上以 REST API 形式提供。阿里巴巴 Happy Horse 1.0——电影感 720p / 1080p 视频,运镜流畅、动作富有表现力、提示词保真度高。包含参考生视频,可在多次生成间保持一致的角色/风格身份。你可以通过编程方式调用它,也可以在上方链接的 Playground 中试用。
如何调用 Happy Horse 1.0 API?
注册 WaveSpeedAI 账号,从 /accesskey 复制你的 API 密钥,然后把输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video。端点会返回预测 ID。从大约每 2 秒一次开始轮询结果端点,长耗时任务可适当拉长间隔,并在任何终止状态时停止。上方有面向生产环境的 Python / Node.js / cURL 示例。
Happy Horse 1.0 API 的费用是多少?
Happy Horse 1.0 每次调用 $0.70 起。实际费用会随你设置的参数(分辨率、时长、输出数量、参考素材)而变化。Playground 中“生成”按钮旁的实时费用预览会显示你当前输入对应的准确价格。
有哪些 Happy Horse 1.0 变体可用?
WaveSpeedAI 托管了 5 个已上线的 Happy Horse 1.0 端点:alibaba/happyhorse-1.0/text-to-video, alibaba/happyhorse-1.0/image-to-video, alibaba/happyhorse-1.0/video-extend, alibaba/happyhorse-1.0/video-edit, alibaba/happyhorse-1.0/reference-to-video。每个变体都有自己的 Playground 页面和定价。
Happy Horse 1.0 的输出可以商用吗?
商用权利遵循 Alibaba 的模型许可。大多数 Alibaba 模型允许商用输出;具体许可摘要请查看各模型的 Playground 页面,平台层面的条件请参阅 WaveSpeedAI 的服务条款。
为什么要在 WaveSpeedAI 上使用 Happy Horse 1.0,而不是直接对接?
一个 API 密钥、一个账单账户,即可使用 Happy Horse 1.0 以及来自其他提供方的 1,000 多个 AI 模型。无需逐家配置 SDK,无需应对各自独立的速率限制,也无需为每家重写集成代码。价格通常与 Alibaba 直接提供的 API 持平或更低。
提供方
关于 Alibaba
Happy Horse 1.0 及 WaveSpeedAI 上 Alibaba 更多模型背后的团队。
阿里巴巴通义实验室推出了 Wan 系列视频模型和 Qwen 系列大语言模型。Wan 以开放权重发布、变体覆盖广泛(文生视频、图生视频、参考生视频、视频编辑、视频延长、图像编辑、文生图)而著称,并在运动稳定性和跨多语言提示词的提示词遵循方面表现稳定。
在 WaveSpeedAI 上用 Happy Horse 1.0 开始构建
注册即送免费体验额度。一个 API 密钥,即可使用来自 Alibaba 及其他所有提供方的 1,000 多个 AI 模型。