主题

语言

视频

HappyHorse API — 如何接入并付费

HappyHorse（Alibaba）— 提供 1.0 和 1.1 版本。Prime 主导 T2V、I2V 和 Reference；Pixel 保留 Video Edit 和多参考图功能。按秒计费。I2V 不带 aspect_ratio（从帧获取）。

渠道对比

渠道	价格
Prime`happyhorse:prime`最便宜	$0.132 起 / 秒
Pixel`happyhorse:pixel`默认	$0.144643 起 / 秒

组合你需要的输出结果

happyhorse:pixel

Duration

Resolution

Model version

Source material

输入： 文本, 图像, 视频某些模式需要附加： source image, reference image, source video, seed for reproducibility

获取 API 密钥

什么是 HappyHorse

契约概览

输入: text, image, video
输出: video
模式: 异步（任务 + 轮询）
状态轮询: 每 3 秒 · 最多 600 秒

优势

定价：按秒
输入：文本、图像、视频
3 个可配置选项
一个 API 密钥用于媒体生成

应用场景

社交媒体短片
宣传片和片头序列
静态图像动画
分镜和动画分镜

请求示例

在 Bearer 请求头中传递密钥。API 会返回 jobId 用于轮询状态。

curl -sS https://getvibeapi.com/api/media/generate \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{"model":"happyhorse:pixel","prompt":"a beautiful landscape","opts":{"version":"1.0","input":"text-to-video","aspect_ratio":"16:9","duration":"6","resolution":"720p"}}'

JavaScript

const response = await fetch('https://getvibeapi.com/api/media/generate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "happyhorse:pixel",
  "prompt": "a beautiful landscape",
  "opts": {
    "version": "1.0",
    "input": "text-to-video",
    "aspect_ratio": "16:9",
    "duration": "6",
    "resolution": "720p"
  }
}),
});

if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);

API 请求参数

通过 GetVibe API 向 HappyHorse 发起请求的参数。

参数

prompt必填

类型

text

取值

text description

默认值

required

价格

—

参数

image_url

类型

URL

取值

Public image URL

默认值

—

价格

—

参数

video_url

类型

URL

取值

Public video URL

默认值

—

价格

—

参数

aspect_ratio

类型

option selection

取值

16:9 (default) · 9:16 · 1:1

默认值

16:9

价格

Included in the base price

参数

duration

类型

option selection

取值

6 (default) · 10

默认值

价格

6: $0.18/s, 10: $0.18/s

参数

version

类型

option selection

取值

1.0 (default) · 1.1 (improved)

默认值

1.0

价格

1.0: $0.18/s, 1.1 (improved): $0.144643/s

参数

input

类型

option selection

取值

Text → video (default) · Image → video · Reference → video · Video Edit

默认值

文本 → 视频

价格

Included in the base price

参数

resolution

类型

option selection

取值

720p (default) · 1080p

默认值

720p

价格

720p: $0.18/s, 1080p: $0.308572/s

参数

reference_image

类型

text / number

取值

any value

默认值

—

价格

Included in the base price

参数

audio_setting

类型

option selection

取值

Auto (default) · Keep original

默认值

自动

价格

Included in the base price

参数

seed

类型

text / number

取值

any value

默认值

—

价格

Included in the base price

参数

image_file_id

类型

text

取值

Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)

默认值

—

价格

Included in the base price

参数

image_base64

类型

text

取值

Alternative to image_url: the file inline, as base64 or a data: URI

默认值

—

价格

Included in the base price

参数

video_file_id

类型

text

取值

Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…)

默认值

—

价格

Included in the base price

参数

video_base64

类型

text

取值

Alternative to video_url: the file inline, as base64 or a data: URI

默认值

—

价格

Included in the base price

参数	类型	取值	默认值	价格
`prompt`必填	text	text description	required	—
`image_url`	URL	Public image URL	—	—
`video_url`	URL	Public video URL	—	—
`aspect_ratio`	option selection	16:9 (default) · 9:16 · 1:1	16:9	Included in the base price
`duration`	option selection	6 (default) · 10	6	6: $0.18/s, 10: $0.18/s
`version`	option selection	1.0 (default) · 1.1 (improved)	1.0	1.0: $0.18/s, 1.1 (improved): $0.144643/s
`input`	option selection	Text → video (default) · Image → video · Reference → video · Video Edit	文本 → 视频	Included in the base price
`resolution`	option selection	720p (default) · 1080p	720p	720p: $0.18/s, 1080p: $0.308572/s
`reference_image`	text / number	any value	—	Included in the base price
`audio_setting`	option selection	Auto (default) · Keep original	自动	Included in the base price
`seed`	text / number	any value	—	Included in the base price
`image_file_id`	text	Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)	—	Included in the base price
`image_base64`	text	Alternative to image_url: the file inline, as base64 or a data: URI	—	Included in the base price
`video_file_id`	text	Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…)	—	Included in the base price
`video_base64`	text	Alternative to video_url: the file inline, as base64 or a data: URI	—	Included in the base price

请求：POST https://getvibeapi.com/api/media/generate。价格以 USD 计。

HappyHorse 的价格

HappyHorse 的费用：从 $0.144643 per second。价格按当前汇率动态计算，最终扣费见 API 响应（priceRub）。以 USD 支付，无订阅。

默认请求的实际费用

若不传参数，请求将使用这些取值：Duration — 6, Resolution — 720p, Model version — 1.0, Source material — Text → video。 该请求的费用为 $1.08。

“$0.144643 起”是最便宜的参数组合，并非默认请求的价格。

各渠道及所有参数组合的价格

每个渠道的每种参数组合价格。这正是成功生成时扣除的金额，与下方链接的机器可读价格表一致。

Pixelhappyhorse:pixel$0.144643 起 / 秒精确价格

宽高比 · 版本 · 输入 \ 分辨率	720p	1080p
16:9 · 1.0 · 文本 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
— · 1.0 · 图片 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
16:9 · 1.0 · 参考 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
— · 1.0 · 视频编辑	$0.18 / 秒	$0.308571–$0.308572 / 秒
16:9 · 1.1（改进版）· 文本 → 视频	$0.144643 / 秒	$0.186429 / 秒
— · 1.1（改进版）· 图片 → 视频	$0.144643 / 秒	$0.186429 / 秒
16:9 · 1.1（改进版）· 参考 → 视频	$0.144643 / 秒	$0.186429 / 秒
9:16 · 1.0 · 文本 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
9:16 · 1.0 · 参考 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
9:16 · 1.1（改进版）· 文本 → 视频	$0.144643 / 秒	$0.186429 / 秒
9:16 · 1.1（改进版）· 参考 → 视频	$0.144643 / 秒	$0.186429 / 秒
1:1 · 1.0 · 文本 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
1:1 · 1.0 · 参考 → 视频	$0.18 / 秒	$0.308571–$0.308572 / 秒
1:1 · 1.1（改进版）· 文本 → 视频	$0.144643 / 秒	$0.186429 / 秒
1:1 · 1.1（改进版）· 参考 → 视频	$0.144643 / 秒	$0.186429 / 秒

所有组合（JSON）： /api/media/price-table?model=happyhorse%3Apixel

Primehappyhorse:prime$0.132 起 / 秒精确价格

宽高比 · 版本 · 输入 \ 分辨率	720p	1080p
16:9 · 1.1（改进版）· 文本 → 视频	$0.132 / 秒	$0.176 / 秒
— · 1.1（改进版）· 图片 → 视频	$0.132 / 秒	$0.176 / 秒
16:9 · 1.1（改进版）· 参考 → 视频	$0.132 / 秒	$0.176 / 秒
9:16 · 1.1（改进版）· 文本 → 视频	$0.132 / 秒	$0.176 / 秒
9:16 · 1.1（改进版）· 参考 → 视频	$0.132 / 秒	$0.176 / 秒
1:1 · 1.1（改进版）· 文本 → 视频	$0.132 / 秒	$0.176 / 秒
1:1 · 1.1（改进版）· 参考 → 视频	$0.132 / 秒	$0.176 / 秒

所有组合（JSON）： /api/media/price-table?model=happyhorse%3Aprime

README

HappyHorse 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。

# HappyHorse

公开模型：happyhorse:pixel
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}

## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `video_url` (URL): Public video URL; 默认: —
- `aspect_ratio` (option selection): 16:9 (default) · 9:16 · 1:1; 默认: 16:9
- `duration` (option selection): 6 (default) · 10; 默认: 6
- `version` (option selection): 1.0 (default) · 1.1 (improved); 默认: 1.0
- `input` (option selection): Text → video (default) · Image → video · Reference → video · Video Edit; 默认: Text → video
- `resolution` (option selection): 720p (default) · 1080p; 默认: 720p
- `reference_image` (text / number): any value; 默认: —
- `audio_setting` (option selection): Auto (default) · Keep original; 默认: Auto
- `seed` (text / number): any value; 默认: —
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
- `video_file_id` (text): Alternative to video_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `video_base64` (text): Alternative to video_url: the file inline, as base64 or a data: URI; 默认: —

## 公开变体
- `happyhorse:prime`: Prime
- `happyhorse:pixel`: Pixel

模型 JSON 契约 Media API 指南 OpenAPI JSON

关于 HappyHorse API 的常见问题

HappyHorse 的价格是多少？

HappyHorse 的价格：从 $0.144643 per second。价格按当前汇率动态计算。

是否兼容 OpenAI SDK？

是的，API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。

立即接入 HappyHorse

一分钟注册，按用量付费，代码已备好。

获取 API 密钥

HappyHorse API — 如何接入并付费

渠道对比

组合你需要的输出结果

什么是 HappyHorse

契约概览

优势

应用场景

API 契约

请求示例

JavaScript

API 请求参数

HappyHorse 的价格

各渠道及所有参数组合的价格

README

关于 HappyHorse API 的常见问题

立即接入 HappyHorse

相似模型