---
title: OpenClaw x HappyHorse 使用指南 | RunAPI
description: 通过 RunAPI 在 OpenClaw 中使用 HappyHorse。比较当前模型 ID、端点与价格，然后按对应流程完成配置。
url: https://runapi.ai/zh-CN/openclaw-happyhorse.md
canonical: https://runapi.ai/zh-CN/openclaw-happyhorse
locale: zh-CN
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/openclaw-happyhorse
  zh-CN: https://runapi.ai/zh-CN/openclaw-happyhorse
  es: https://runapi.ai/es/openclaw-happyhorse
  ja: https://runapi.ai/ja/openclaw-happyhorse
  de: https://runapi.ai/de/openclaw-happyhorse
  fr: https://runapi.ai/fr/openclaw-happyhorse
  pt-BR: https://runapi.ai/pt-BR/openclaw-happyhorse
  ko: https://runapi.ai/ko/openclaw-happyhorse
  it: https://runapi.ai/it/openclaw-happyhorse
  nl: https://runapi.ai/nl/openclaw-happyhorse
  pl: https://runapi.ai/pl/openclaw-happyhorse
  tr: https://runapi.ai/tr/openclaw-happyhorse
  zh-TW: https://runapi.ai/zh-TW/openclaw-happyhorse
  zh-HK: https://runapi.ai/zh-HK/openclaw-happyhorse
  ar: https://runapi.ai/ar/openclaw-happyhorse
  x-default: https://runapi.ai/openclaw-happyhorse
model_line: happyhorse
---

> HTML version: https://runapi.ai/zh-CN/openclaw-happyhorse
> Site index for agents: https://runapi.ai/llms.txt


<!-- agent-model-guide-section: breadcrumb_hero owner=API-1798 state=ready -->

[OpenClaw](https://runapi.ai/zh-CN/openclaw.md) / [HappyHorse](https://runapi.ai/zh-CN/models/happyhorse.md)

# OpenClaw x HappyHorse

HappyHorse 属于 RunAPI 的 Alibaba catalog，在 API、SDK、CLI、Bruno 和文档中提供规范化的文生视频、图生视频和视频编辑能力。

- [获取 API Key](https://runapi.ai/zh-CN/login)
- [查看 OpenClaw 文档](https://runapi.ai/zh-CN/docs/guides)

<!-- agent-model-guide-section: key_facts owner=API-1800 state=ready -->
7 variants · 起价 $0.41 / 秒 · 可商用


<!-- agent-model-guide-section: prompt_terminal owner=API-1808 state=ready -->
## Prompt

Prerequisite: `npx runapi mcp install`

```text
You have access to RunAPI task tools for HappyHorse.

Available HappyHorse models:
- happyhorse-1.0-i2v: HappyHorse 1.0 首帧图生视频
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-1.0-r2v: HappyHorse 1.0 基于 1-9 张有序参考图生成视频
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-1.0-t2v: HappyHorse 1.0 文生视频，支持 720p 或 1080p
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-character: 基于 1-9 张有序参考图生成 3-15 秒文生视频
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-edit-video: 基于源视频和可选参考图进行提示词编辑
  endpoints: /api/v1/happyhorse/edit_video
  request fields: model, prompt, source_video_url
- happyhorse-image-to-video: 基于单张首帧图生成 3-15 秒视频
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-text-to-video: 3-15 秒文生视频，支持 720p 或 1080p
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls

Use the model ID and endpoint that match the user's request.
Example prompt: 生成一段 5 秒 1080p 电影感视频：纸马在夜晚的迷你纸板城市中奔跑。
/api/v1/happyhorse/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/image_to_video，并保存返回的 Task ID。
GET /api/v1/happyhorse/image_to_video/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/happyhorse/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/text_to_video，并保存返回的 Task ID。
GET /api/v1/happyhorse/text_to_video/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/happyhorse/edit_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/edit_video，并保存返回的 Task ID。
GET /api/v1/happyhorse/edit_video/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
```





<!-- agent-model-guide-section: prompt_model_tabs owner=API-1812 state=ready -->
## Prompt 模型

通过本指南使用 RunAPI 和 HappyHorse。

可用的 HappyHorse 模型：

- `happyhorse-1.0-i2v`: HappyHorse 1.0 首帧图生视频
- `happyhorse-1.0-r2v`: HappyHorse 1.0 基于 1-9 张有序参考图生成视频
- `happyhorse-1.0-t2v`: HappyHorse 1.0 文生视频，支持 720p 或 1080p
- `happyhorse-character`: 基于 1-9 张有序参考图生成 3-15 秒文生视频
- `happyhorse-edit-video`: 基于源视频和可选参考图进行提示词编辑
- `happyhorse-image-to-video`: 基于单张首帧图生成 3-15 秒视频
- `happyhorse-text-to-video`: 3-15 秒文生视频，支持 720p 或 1080p
任务匹配时使用 happyhorse-1.0-i2v：HappyHorse 1.0 首帧图生视频。



<!-- agent-model-guide-section: versions_endpoints owner=API-1817 state=runtime_fallback -->

## 公开版本与端点

| 模型 ID | 版本 | 端点 | 起步价格 |
| --- | --- | --- | --- |
| `happyhorse-1.0-i2v` | HappyHorse 1.0 首帧图生视频 | /api/v1/happyhorse/image_to_video | $0.41 / 秒 |
| `happyhorse-1.0-r2v` | HappyHorse 1.0 基于 1-9 张有序参考图生成视频 | /api/v1/happyhorse/text_to_video | $0.41 / 秒 |
| `happyhorse-1.0-t2v` | HappyHorse 1.0 文生视频，支持 720p 或 1080p | /api/v1/happyhorse/text_to_video | $0.41 / 秒 |
| `happyhorse-character` | 基于 1-9 张有序参考图生成 3-15 秒文生视频 | /api/v1/happyhorse/text_to_video | $0.41 / 秒 |
| `happyhorse-edit-video` | 基于源视频和可选参考图进行提示词编辑 | /api/v1/happyhorse/edit_video | $0.48 / 秒 |
| `happyhorse-image-to-video` | 基于单张首帧图生成 3-15 秒视频 | /api/v1/happyhorse/image_to_video | $0.41 / 秒 |
| `happyhorse-text-to-video` | 3-15 秒文生视频，支持 720p 或 1080p | /api/v1/happyhorse/text_to_video | $0.41 / 秒 |


<!-- agent-model-guide-section: verify_code_block owner=API-1824 state=runtime_fallback -->

## 验证

轮询，直到 Task 进入终态

POST <endpoint>，并保存返回的 Task ID。
GET <endpoint>/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。



## 配置

设置 `RUNAPI_API_KEY`，然后向 `<endpoint>` 发送包含 `<model-id>` 的请求。仅当端点返回异步 Task 时才轮询。

```shell
export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai<endpoint> \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json
```


<!-- agent-model-guide-section: three_step_flow owner=API-1830 state=ready -->

## 三步开始使用

1. **选择模型 ID.** 选择公开模型 ID，并查看其端点与当前起步价格。
2. **配置 RunAPI.** 调用端点前设置 RUNAPI_API_KEY。
3. **验证结果.** 对于异步端点，轮询同一端点，直到 Task 进入终态。



<!-- agent-model-guide-section: use_case_cards owner=API-1837 state=ready -->

## 使用 OpenClaw + HappyHorse 可以构建什么

**产品与营销短片**

根据文字需求为商品页、广告和落地页制作简短的宣传短片。

**社交媒体短视频**

为社交平台制作短视频，并对同一创意生成多个版本后再挑选。

**图片动画与视频编辑**

在模型提供图生视频或视频编辑端点时，让静态图片动起来或修改现有视频。



<!-- agent-model-guide-section: benefit_cards owner=API-1844 state=ready -->

## 为什么通过 RunAPI + OpenClaw 使用 HappyHorse

**7 个变体，一个 API 密钥**

通过一个 RunAPI 连接选择可用的模型变体，无需更改现有集成。

**清晰的用量价格**

发送请求前查看目录中的当前价格，无需订阅或最低消费。

**自动化任务流程**

通过一致的任务流程提交任务、查询状态并收集异步结果，无需编写手动轮询代码。




<!-- agent-model-guide-section: faq owner=API-1851 state=ready -->

## OpenClaw + HappyHorse 常见问题

### HappyHorse 支持哪些视频能力？

HappyHorse 支持根据提示词生成视频、使用角色模型和有序参考图生成视频、用一张首帧图片生成视频，也支持基于一个源视频做编辑。

### HappyHorse 支持哪些分辨率？

所有 HappyHorse 视频端点都支持 720p 和 1080p 输出。默认是 1080p，720p 更适合草稿和社交视频。

### HappyHorse 视频最长多久？

HappyHorse 视频生成端点支持 3 到 15 秒整数时长，视频编辑接受 3 到 60 秒源视频。

### 图生视频如何使用输入图片？

图生视频接收且只接收一个公开图片 URL，并将其作为首帧，再结合提示词和参数生成运动。

### 角色模型如何使用参考图？

角色模型在文生视频端点接收 1-9 个公开图片 URL；顺序对应提示词中的 character1、character2 等引用。

### 视频编辑如何使用源视频？

视频编辑接收一个公开 MP4 或 MOV 源视频、一段编辑指令，以及最多 5 张可选参考图。

### 可以复现 HappyHorse 结果吗？

可以传入 seed，让相同提示词、媒体和分辨率下的生成更可复现。

### 应该使用哪个模型 ID？

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

### 本指南会配置聊天模型吗？

不会。该 Model Line 使用页面所示的端点流程，不会被描述为 Agent 聊天模型。




<!-- agent-model-guide-section: related_guides owner=API-1859 state=ready -->

## 更多 OpenClaw 指南

- [OpenClaw x Claude](https://runapi.ai/zh-CN/openclaw-claude.md) - Anthropic · 文本 · 起价 $0.60 / 百万 tokens
- [OpenClaw x DeepSeek](https://runapi.ai/zh-CN/openclaw-deepseek.md) - DeepSeek · 文本 · 起价 $0.30 / 百万 tokens
- [OpenClaw x ElevenLabs](https://runapi.ai/zh-CN/openclaw-elevenlabs.md) - ElevenLabs · 音频与音乐 · 起价 $0.04 / 分钟
- [OpenClaw x Embedding](https://runapi.ai/zh-CN/openclaw-embedding.md) - OpenAI · 文本 · 起价 $0.02 / 百万 tokens


<!-- agent-model-guide-section: final_cta owner=API-1866 state=ready -->

## 开始在 OpenClaw 中使用 HappyHorse

- [获取 API Key](https://runapi.ai/zh-CN/login)
- [阅读快速开始](https://runapi.ai/zh-CN/docs/guides)


<!-- agent-model-guide-section: team_contact_cta owner=API-1873 state=ready -->
## 需要团队接入支持？

我们可以协助团队接入、完成系统集成并解答技术问题。

[联系我们](https://runapi.ai/zh-CN/contact.md)




<!-- agent-model-guide-section: footer owner=API-1880 state=shared -->


---

## More from RunAPI

- [Home](https://runapi.ai/zh-CN/.md)
### 产品
- [模型目录](https://runapi.ai/zh-CN/models.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [提供方](https://runapi.ai/zh-CN/models#all-models)
### 开发者
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [x402](https://runapi.ai/zh-CN/x402.md)
### 指南
- [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md)
- [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md)
### 公司
- [企业版](https://runapi.ai/zh-CN/contact.md)
- [联系](https://runapi.ai/zh-CN/contact.md)
### 法律
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai


## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "SoftwareApplication",
    "name": "OpenClaw x HappyHorse",
    "applicationCategory": "DeveloperApplication",
    "description": "通过 RunAPI 在 OpenClaw 中使用 HappyHorse。比较当前模型 ID、端点与价格，然后按对应流程完成配置。",
    "url": "https://runapi.ai/zh-CN/openclaw-happyhorse"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "HappyHorse 支持哪些视频能力？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "HappyHorse 支持根据提示词生成视频、使用角色模型和有序参考图生成视频、用一张首帧图片生成视频，也支持基于一个源视频做编辑。"
        }
      },
      {
        "@type": "Question",
        "name": "HappyHorse 支持哪些分辨率？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "所有 HappyHorse 视频端点都支持 720p 和 1080p 输出。默认是 1080p，720p 更适合草稿和社交视频。"
        }
      },
      {
        "@type": "Question",
        "name": "HappyHorse 视频最长多久？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "HappyHorse 视频生成端点支持 3 到 15 秒整数时长，视频编辑接受 3 到 60 秒源视频。"
        }
      },
      {
        "@type": "Question",
        "name": "图生视频如何使用输入图片？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "图生视频接收且只接收一个公开图片 URL，并将其作为首帧，再结合提示词和参数生成运动。"
        }
      },
      {
        "@type": "Question",
        "name": "角色模型如何使用参考图？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "角色模型在文生视频端点接收 1-9 个公开图片 URL；顺序对应提示词中的 character1、character2 等引用。"
        }
      },
      {
        "@type": "Question",
        "name": "视频编辑如何使用源视频？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "视频编辑接收一个公开 MP4 或 MOV 源视频、一段编辑指令，以及最多 5 张可选参考图。"
        }
      },
      {
        "@type": "Question",
        "name": "可以复现 HappyHorse 结果吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以传入 seed，让相同提示词、媒体和分辨率下的生成更可复现。"
        }
      },
      {
        "@type": "Question",
        "name": "应该使用哪个模型 ID？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。"
        }
      },
      {
        "@type": "Question",
        "name": "本指南会配置聊天模型吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不会。该 Model Line 使用页面所示的端点流程，不会被描述为 Agent 聊天模型。"
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "HowTo",
    "name": "在 OpenClaw 中使用 HappyHorse",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "选择模型 ID",
        "text": "选择公开模型 ID，并查看其端点与当前起步价格。",
        "url": "https://runapi.ai/zh-CN/openclaw-happyhorse#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "配置 RunAPI",
        "text": "调用端点前设置 RUNAPI_API_KEY。",
        "url": "https://runapi.ai/zh-CN/openclaw-happyhorse#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "验证结果",
        "text": "对于异步端点，轮询同一端点，直到 Task 进入终态。",
        "url": "https://runapi.ai/zh-CN/openclaw-happyhorse#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "首页",
        "item": "https://runapi.ai/zh-CN"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "OpenClaw",
        "item": "https://runapi.ai/zh-CN/openclaw"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "HappyHorse",
        "item": "https://runapi.ai/zh-CN/openclaw-happyhorse"
      }
    ]
  }
]
```
