统一认证，接入所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
curl -X POST https://runapi.ai/api/v1/happyhorse/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-text-to-video",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "生成一段 5 秒 1080p 电影感视频：纸马在夜晚的迷你纸板城市中奔跑。"
}'import { HappyhorseClient } from "@runapi.ai/happyhorse";
const client = new HappyhorseClient();
const result = await client.imageToVideo.run({
model: "happyhorse-text-to-video",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 5 秒 1080p 电影感视频：纸马在夜晚的迷你纸板城市中奔跑。",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Happyhorse\HappyhorseClient;
$client = new HappyhorseClient();
$result = $client->imageToVideo->run([
'model' => 'happyhorse-text-to-video',
'first_frame_image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => '生成一段 5 秒 1080p 电影感视频：纸马在夜晚的迷你纸板城市中奔跑。',
]);require "runapi/happyhorse"
client = RunApi::Happyhorse::Client.new
result = client.image_to_video.run(
model: "happyhorse-text-to-video",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 5 秒 1080p 电影感视频：纸马在夜晚的迷你纸板城市中奔跑。"
)npx skills add runapi-ai/happyhorse -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor概览
关于 HappyHorse
HappyHorse 可根据提示词、首帧图片、角色模型有序参考图或源视频编辑指令创建视频片段，支持 720p 或 1080p 输出和 seed 控制。
提供方
Alibaba
模态
视频
对比全部 API 变体
定价
HappyHorse 定价
| Endpoint | 分辨率 | 时长 | 价格 | |
|---|---|---|---|---|
| image_to_video | 720p, 1080p | — | $0.14-$0.24 / 秒 |
当前价格适用于 happyhorse-1.0-i2v。其他变体保留各自的 endpoint 定价。
Agent 集成
通过 Agent 运行 HappyHorse
工作流程
开始使用 HappyHorse
-
选择模型
根据输出类型、质量要求和延迟目标选择模型与变体。
-
配置
设置 RunAPI key，并在代码工作区安装对应 model skill。
-
调用
按 skill 里的说明，把模型能力接入到你的应用里。
-
接收
按 task ID 轮询、在支持时使用流式，或处理 webhook 回调。
为什么用 RunAPI 调用 HappyHorse API
统一的定价与账单
USD 按次定价，按月结算。失败的生成不计费。
Schema 优先的 SDK
Typed schema 和接入说明已打包进 model skill，让实现从正确契约开始。
HappyHorse 常见问题
HappyHorse 支持哪些视频能力？
HappyHorse 支持根据提示词生成视频、使用角色模型和有序参考图生成视频、用一张首帧图片生成视频，也支持基于一个源视频做编辑。
HappyHorse 支持哪些分辨率？
所有 HappyHorse 视频端点都支持 720p 和 1080p 输出。默认是 1080p，720p 更适合草稿和社交视频。
HappyHorse 视频最长多久？
HappyHorse 视频生成端点支持 3 到 15 秒整数时长，视频编辑接受 3 到 60 秒源视频。
图生视频如何使用输入图片？
图生视频接收且只接收一个公开图片 URL，并将其作为首帧，再结合提示词和参数生成运动。
角色模型如何使用参考图？
角色模型在文生视频端点接收 1-9 个公开图片 URL；顺序对应提示词中的 character1、character2 等引用。
视频编辑如何使用源视频？
视频编辑接收一个公开 MP4 或 MOV 源视频、一段编辑指令，以及最多 5 张可选参考图。
相似模型