教程

如何在 EvoLink 上使用 HappyHorse API

Q: 调用 HappyHorse 用哪个接口？

使用 POST /v1/videos/generations 创建任务，使用 GET /v1/tasks/{task_id} 获取任务状态和结果。

Q: 应该使用哪个 HappyHorse 模型名称？

提示词优先测试从 happyhorse-1.0-text-to-video 开始。当工作流需要图片、参考图或源视频时，使用 happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video 或 happyhorse-1.0-video-edit。

EvoLink Team

Product Team

2026年4月27日

6 分钟阅读

HappyHorse API 指南：通过 EvoLink 调用 HappyHorse 1.0

HappyHorse 1.0 现已可通过 EvoLink 的统一视频 API 调用。如果你搜索的是 "HappyHorse API"，最快的方式是直接访问 HappyHorse API 页面，在那里你可以测试模型、查看当前路由定价并检查实时 API 接口。

本指南面向开发者，讲解集成细节，让模型页面继续承载交易型搜索，而本文覆盖接入流程。

快速上手

使用 POST /v1/videos/generations 创建 HappyHorse 视频任务。
使用 GET /v1/tasks/{task_id} 轮询异步结果。
当前可用的路由变体包括 happyhorse-1.0-text-to-video、happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video 和 happyhorse-1.0-video-edit。
EvoLink 路由定价按秒计费，当前定价表为 720p 12.15 credits/s，1080p 乘以 1.778x。
API 接入、定价和 Playground 测试请访问 HappyHorse API 页面。

HappyHorse API 模型名称

工作流	模型名称	适用场景
文生视频	`happyhorse-1.0-text-to-video`	提示词驱动的视频生成
图生视频	`happyhorse-1.0-image-to-video`	将首帧图片动画化
参考图生视频	`happyhorse-1.0-reference-to-video`	使用 1-9 张参考图
视频编辑	`happyhorse-1.0-video-edit`	通过文字指令编辑源视频

这些变体共享同一套 EvoLink 模式：提交异步生成任务、获取任务 ID、任务完成后拉取结果。

基本请求模式

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-text-to-video",
    "prompt": "一匹铬金属质感的马雕塑在黑色玻璃桌上缓慢旋转，影棚灯光，镜头缓慢推进",
    "quality": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

响应返回任务 ID，使用该 ID 轮询任务接口：

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<TASK_ID> \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>'

首先检查的参数

参数	典型取值	说明
`model`	`happyhorse-1.0-text-to-video`	选择适合工作流的 HappyHorse 变体
`prompt`	文本提示词	提示词驱动生成和编辑时必填
`quality`	`720p`、`1080p`	1080p 使用更高的倍率
`duration`	`3-15` 秒	适用于生成变体，不适用于视频编辑
`aspect_ratio`	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`	文生视频和参考图生视频支持画幅选择
`image_urls`	1 张图片或 1-9 张参考图	图生视频/参考图工作流必填
`video_urls`	源视频 URL	视频编辑必填

何时使用哪个 HappyHorse 变体

使用 文生视频 来完成对 HappyHorse 质量的第一次测试。它最适合 happyhorse api 和 happyhorse 文生视频 相关搜索。

使用 图生视频 当首帧画面很重要时。适合产品视觉、角色一致性和设计驱动的创意测试。

使用 参考图生视频 当你有多张参考图，希望提示词将它们作为角色或物件引用。

使用 视频编辑 当你已有源视频并希望通过指令对其进行修改。视频编辑的计费基于总时长规则，而非简单的输出时长估算。

定价范围

本指南讨论的是 EvoLink 路由定价，而非通用的官方供应商价格。

当前 HappyHorse 定价实现如下：

质量	定价基准
720p	`12.15 credits/s`
1080p	720p 费率的 `1.778x`

视频编辑使用特殊时长规则：计费基于输入视频时长加输出视频时长，源视频时长设有计费上限。正式使用前请在 HappyHorse API 页面确认实时价格表。

本页在 SEO 内容集群中的位置

搜索查询	最佳着陆页
`happyhorse api`	HappyHorse API 页面
`happyhorse api 使用方法`	本指南
`happyhorse 定价`	HappyHorse 定价指南
`happyhorse vs seedance`	HappyHorse vs Seedance
`happyhorse 开源`	HappyHorse 发布观察

打开 HappyHorse API 页面

常见问题

HappyHorse API 现在可用吗？

可以。HappyHorse 1.0 现已可通过 EvoLink 的统一视频 API 调用。

调用 HappyHorse 用哪个接口？

使用 POST /v1/videos/generations 创建任务，使用 GET /v1/tasks/{task_id} 获取任务状态和结果。

应该使用哪个 HappyHorse 模型名称？

提示词优先测试从 happyhorse-1.0-text-to-video 开始。当工作流需要图片、参考图或源视频时，使用 happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video 或 happyhorse-1.0-video-edit。