Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
概述
HappyHorse(快马) 是阿里系视频生成模型系列,主打高度还原的动态画面生成——精准理解文本语义,输出流畅自然、细节丰富、主体保持稳定的高质量视频。API易 通过 DashScope 透传通道 直连,让你用一个 API易 Key 即可调用全部 HappyHorse 能力。当前版本 HappyHorse-1.0 覆盖四种核心玩法:| 玩法 | 模型 ID | 你给的输入 | 产出 |
|---|---|---|---|
| 文生视频 | happyhorse-1.0-t2v | 一段文本 prompt | 短视频 |
| 图生视频 | happyhorse-1.0-i2v | 首帧图 + prompt | 让静态图”动起来”(不支持音频驱动) |
| 参考图生视频 | happyhorse-1.0-r2v | 最多 9 张参考图 + prompt | 主体与场景高度还原的视频 |
| 视频编辑 | happyhorse-1.0-video-edit | 视频 + 最多 5 张参考图 + 指令 | 局部/全局编辑后的视频 |
🐎 核心亮点:四种能力共用同一个异步端点和同一套请求结构,切换玩法只改
model 字段。HappyHorse 偏「高度还原动态画面」,参考图生视频支持 最多 9 张参考图、视频编辑支持 最多 5 张参考图,主体一致性强。与 Wan 系列 同端点、可直接互换。文生视频 API
happyhorse-1.0-t2v,纯文本提示词生成视频。图生视频 API
happyhorse-1.0-i2v,首帧图生成视频(无音频驱动)。参考图生视频 API
happyhorse-1.0-r2v,最多 9 张参考图保持主体。视频编辑 API
happyhorse-1.0-video-edit,最多 5 张参考图编辑视频。为什么选 API易 的 HappyHorse
一个 Key 调全部能力
无需注册阿里云、无需配置地域。一把 API易 Key 即可调用 HappyHorse 全部四种能力以及 Wan 系列。
国内直连 · 免出海
直连
api.apiyi.com,国内机房、家宽网络均可访问。失败不计费
任务进入
failed 状态(媒体 URL 不可达、prompt 涉敏等)不计费,可放心重试。DashScope 协议透传
与 Wan 系列共用同一端点和 schema,已有 Wan 代码切
model 名即可调用 HappyHorse。核心特性
四合一异步端点
t2v / i2v / r2v / video-edit 共用
POST /wan/api/v1/...video-synthesis,提交后返回 task_id,轮询 + 下载。主体高度还原
模型整体偏「高度还原动态画面」风格,人物/物体在动态过程中保持得更稳。
最多 9 张参考图
happyhorse-1.0-r2v 官方支持最多 9 张 reference_image,多参考图场景的主体一致性更强。多档分辨率与时长
720P / 1080P 分辨率,2–15 秒整数时长,
prompt_extend 智能改写提升短 prompt 画质。支持的模型
| 模型 ID | 能力 | 必需媒体输入 | 说明 |
|---|---|---|---|
happyhorse-1.0-t2v | 文生视频 | 无 | 纯文本生成 |
happyhorse-1.0-i2v | 图生视频 | first_frame | 不支持 driving_audio |
happyhorse-1.0-r2v | 参考图生视频 | reference_image(最多 9 张) | 多参考图主体保持 |
happyhorse-1.0-video-edit | 视频编辑 | video + reference_image(最多 5 张) | 模型名 有连字符 |
分组介绍
HappyHorse 与 Wan 两个系列共用同一个Wan 分组——一把令牌即可同时调用两个系列(如图令牌名 Wan2.7&HappyHorse)。视频模型按秒计费,令牌必须同时满足两个条件才能成功路由:
- 计费模式:选「按量优先」或「按量计费」—— 视频按秒计费,按次计费的令牌无法路由
- 分组:选择包含
Wan

模型定价
默认价格 = 阿里云官方原价的 98%(理解简单)
控制台里Wan 分组显示倍率 0.14x,这是按人民币计价单位计的。本站统一用美元充值、固定汇率 1:7,实际折算:
换算公式:本站每秒美元价 = 官方人民币原价 × 0.14(即 × 0.98 ÷ 7)。
价格明细(默认价,按秒计费)
HappyHorse-1.0 文生 / 图生 / 参考生视频同价,仅720P / 1080P 两档(不支持 480P):
| 分辨率 | 官方原价 | 本站默认价/秒 | 5 秒 | 10 秒 | 12 秒 |
|---|---|---|---|---|---|
720P | ¥0.9/秒 | $0.126/秒 | $0.63 | $1.26 | $1.51 |
1080P | ¥1.6/秒 | $0.224/秒 | $1.12 | $2.24 | $2.69 |
happyhorse-1.0-video-edit(视频编辑)输出时长跟随源视频,按实际输出秒数计费,不由duration决定。- 表中为 默认价(官方 98%);叠加充值加赠最高档约为表中价 ÷ 1.2(例:1080P 5 秒 $1.12 → 约 $0.93)。
叠加充值加赠,折扣进一步走低
参与 充值加赠活动 后,到账额度最高可放大约 1.2 倍,等效价格进一步下探:| 档位 | 等效价格(对比阿里云官方原价) | 算法 |
|---|---|---|
| 默认 | 98%(98 折) | 倍率 0.14x × 固定汇率 7 |
| 叠加充值加赠(大客户最高档) | 约 81.6%(约 82 折) | 0.98 ÷ 1.2 |
⚠️ 端点选择(最重要)
API易 同时挂载两条路径,只有 DashScope 透传端点对 HappyHorse 全部能力完整可用:| 路径 | 协议风格 | i2v / r2v 可用性 | 结论 |
|---|---|---|---|
/v1/videos | OpenAI 扁平风格 | ❌ 媒体字段会被丢弃 | 不要用 |
/wan/api/v1/services/aigc/video-generation/video-synthesis | DashScope 原生透传 | ✅ 完整可用 | 始终用这条 |
异步调用流程
整套流程是异步的三步:创建任务 → 轮询状态 → 下载视频。创建任务
POST /wan/api/v1/services/aigc/video-generation/video-synthesis,请求头带 X-DashScope-Async: enable,立刻返回 task_id。任务状态说明
| 状态 | 含义 | 下一步操作 |
|---|---|---|
submitted | 已提交,排队中 | 继续轮询 |
in_progress | 生成中 | 继续轮询(progress 常停在 30%,是上游汇报粒度粗,不是卡住) |
completed | 成功 | 从 result_url 下载 |
failed | 失败 | 看 error.message / fail_reason |
完整 Python 客户端
关键参数详解
提交时 body 为 DashScope 嵌套结构:{ model, input: { prompt, media[] }, parameters: {...} }。
media[] 类型
type | 用途 | 适用模型 |
|---|---|---|
first_frame | 首帧图(≤1 张) | i2v、r2v |
reference_image | 参考图(r2v 最多 9 张,video-edit 最多 5 张) | r2v、video-edit |
video | 输入视频 | video-edit |
parameters 字段
| 字段 | 类型 | 取值 | 说明 |
|---|---|---|---|
resolution | string | 720P / 1080P | 大写,建议显式指定 |
duration | int | 2–15 | 秒数(整数),常用 5 / 10 |
prompt_extend | bool | true / false | 智能改写 prompt,强烈推荐 true |
watermark | bool | true / false | 右下角「AI 生成」水印 |
seed | int | 0–2147483647 | 固定可提升可复现性 |
如何选择 HappyHorse 还是 Wan
HappyHorse 和 Wan 都是阿里系视频模型、共用同一端点和 schema(只改model 名即可互换),侧重不同:
| 维度 | HappyHorse-1.0 | Wan2.7 |
|---|---|---|
| 音频驱动对口型(i2v) | ❌ 不支持,i2v 仅首帧 | ✅ wan2.7-i2v 支持 driving_audio |
| 参考图生视频上限 | 参考图最多 9 张 | 参考图 + 参考视频合计 ≤5 |
| 视频编辑参考图 | ≤5 张 | ≤5 张 |
| 风格侧重 | 高度还原动态画面,主体保持稳 | 多主体互动、音色参考 |
最佳实践
错误码与重试
| 来源 | 特征 | 处理 |
|---|---|---|
| 创建阶段(API易 拒) | HTTP 4xx/5xx,type 为 task_error / parse_request_failed / build_request_failed | 改 body 重试(字段类型错、缺 media、用错端点) |
| 执行阶段(上游阿里云拒) | 任务 status=failed,error.message 以 [InvalidParameter] / [InvalidImageUrl] 等方括号前缀打头 | 看方括号提示,多为媒体 URL 不可达或 prompt 涉敏 |
建议客户端:HTTP 5xx / 网络错误做指数退避重试;HTTP 4xx 立刻 surface 不重试;任务
failed 含 [InvalidImageUrl] 可重试,含 [InvalidParameter] / 敏感词不重试。常见问题
HappyHorse 和 Wan 接入有差别吗?
HappyHorse 和 Wan 接入有差别吗?
没有。两者共用同一个 DashScope 透传端点、同一套请求结构、同一组 media type 名、同一个查询端点。切换只改
model 字段(如 wan2.7-t2v → happyhorse-1.0-t2v),body 其余部分一字不改。HappyHorse 的 i2v 为什么不能做对口型?
HappyHorse 的 i2v 为什么不能做对口型?
happyhorse-1.0-i2v 不支持 driving_audio(音频驱动)字段,i2v 只接受 first_frame。做对口型 / rap / 数字人口播请用 Wan2.7-i2v。happyhorse-1.0-r2v 真的能塞 9 张参考图吗?
happyhorse-1.0-r2v 真的能塞 9 张参考图吗?
可以。官方说最多 9 张
reference_image,直接放在 media 数组里即可。多参考图能让主体/服装/场景一致性更强。为什么不能用 /v1/videos 提交?
为什么不能用 /v1/videos 提交?
/v1/videos 对 i2v / r2v 的 media 字段适配不完整,会导致上游报 [InvalidParameter] Field required: input.media。所有创建请求都走 /wan/api/v1/services/aigc/video-generation/video-synthesis,查询走 /v1/tasks/{task_id}。result_url 下载报 403 怎么办?
result_url 下载报 403 怎么办?
去掉
Authorization 头。result_url 已是 OSS 签好名的直链,再带 API易 Key 反而被 OSS 拒。result_url 默认 24 小时过期,请尽快下载落地。失败任务扣费吗?
失败任务扣费吗?
status=failed 不扣费。但重复提交相同任务会重复计费,做好幂等。相关文档
文生视频 Playground
happyhorse-1.0-t2v 在线调试图生视频 Playground
happyhorse-1.0-i2v 首帧生成参考图生视频 Playground
happyhorse-1.0-r2v 最多 9 张参考图视频编辑 Playground
happyhorse-1.0-video-edit 换装 / 换背景Wan 系列
同为阿里系,选型对照
HappyHorse 系列通过 API易 DashScope 透传通道提供。如有问题或建议,欢迎在 API易控制台 工单中反馈。