--- title: OpenClaw x HeyGen Video 使用指南 | RunAPI description: 通过 RunAPI 在 OpenClaw 中使用 HeyGen Video。比较当前模型 ID、端点与价格，然后按对应流程完成配置。 url: https://runapi.ai/zh-CN/openclaw-heygen-video.md canonical: https://runapi.ai/zh-CN/openclaw-heygen-video locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/openclaw-heygen-video zh-CN: https://runapi.ai/zh-CN/openclaw-heygen-video es: https://runapi.ai/es/openclaw-heygen-video ja: https://runapi.ai/ja/openclaw-heygen-video de: https://runapi.ai/de/openclaw-heygen-video fr: https://runapi.ai/fr/openclaw-heygen-video pt-BR: https://runapi.ai/pt-BR/openclaw-heygen-video ko: https://runapi.ai/ko/openclaw-heygen-video it: https://runapi.ai/it/openclaw-heygen-video nl: https://runapi.ai/nl/openclaw-heygen-video pl: https://runapi.ai/pl/openclaw-heygen-video tr: https://runapi.ai/tr/openclaw-heygen-video zh-TW: https://runapi.ai/zh-TW/openclaw-heygen-video zh-HK: https://runapi.ai/zh-HK/openclaw-heygen-video ar: https://runapi.ai/ar/openclaw-heygen-video x-default: https://runapi.ai/openclaw-heygen-video model_line: heygen-video --- > HTML version: https://runapi.ai/zh-CN/openclaw-heygen-video > Site index for agents: https://runapi.ai/llms.txt [OpenClaw](https://runapi.ai/zh-CN/openclaw.md) / [HeyGen Video](https://runapi.ai/zh-CN/models/heygen-video.md) # OpenClaw x HeyGen Video 文生视频、图生视频和参考引导生成共用一个 RunAPI 模型 ID。输出分辨率为 480p 至 2K；参考模式最多支持 9 张图片、3 段视频和 3 段音频，参考文件总数不超过 12 个。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [查看 OpenClaw 文档](https://runapi.ai/zh-CN/docs/guides) 1 variants · 起价 $0.09 / 秒 · 可商用 ## Prompt Prerequisite: `npx runapi mcp install` ```text You have access to RunAPI task tools for HeyGen Video. Available HeyGen Video models: - heygen-video-1: heygen-video-1 endpoints: /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video request fields: model, prompt, output_resolution, aspect_ratio Use the model ID and endpoint that match the user's request. Example prompt: 生成一段 10 秒 1080p 的产品视频：阳光照进的厨房台面上放着一只陶瓷马克杯，使用参考图片保持杯子设计一致，并加入轻柔的环境音。 /api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/text_to_video，并保存返回的 Task ID。 GET /api/v1/heygen_video/text_to_video/，直到状态为 completed 或 failed。 确认 completed 响应包含 API 参考中记录的端点专属输出。 /api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/image_to_video，并保存返回的 Task ID。 GET /api/v1/heygen_video/image_to_video/，直到状态为 completed 或 failed。 确认 completed 响应包含 API 参考中记录的端点专属输出。 ``` ## Prompt 模型 通过本指南使用 RunAPI 和 HeyGen Video。 - `heygen-video-1`: heygen-video-1 任务匹配时使用 heygen-video-1：heygen-video-1。 ## 公开版本与端点 | 模型 ID | 版本 | 端点 | 起步价格 | | --- | --- | --- | --- | | `heygen-video-1` | heygen-video-1 | /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video | $0.09 / 秒 | ## 验证 轮询，直到 Task 进入终态 ``` POST /api/v1/heygen_video/text_to_video，并保存返回的 Task ID。 GET /api/v1/heygen_video/text_to_video/，直到状态为 completed 或 failed。 确认 completed 响应包含 API 参考中记录的端点专属输出。 ``` ## 配置 设置 `RUNAPI_API_KEY`，然后向 `` 发送包含 `` 的请求。仅当端点返回异步 Task 时才轮询。 ```shell export RUNAPI_API_KEY=your_api_key curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \ -H "Authorization: Bearer $RUNAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "heygen-video-1", "prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.", "output_resolution": "768p", "aspect_ratio": "16:9" }' ``` ## 三步开始使用 1. **选择模型 ID.** 选择公开模型 ID，并查看其端点与当前起步价格。 2. **配置 RunAPI.** 调用端点前设置 RUNAPI_API_KEY。 3. **验证结果.** 对于异步端点，轮询同一端点，直到 Task 进入终态。 ## 使用 OpenClaw + HeyGen Video 可以构建什么 **产品与营销短片** 根据文字需求为商品页、广告和落地页制作简短的宣传短片。 **社交媒体短视频** 为社交平台制作短视频，并对同一创意生成多个版本后再挑选。 **图片动画与视频编辑** 在模型提供图生视频或视频编辑端点时，让静态图片动起来或修改现有视频。 ## 为什么通过 RunAPI + OpenClaw 使用 HeyGen Video **1 个变体，一个 API 密钥** 通过一个 RunAPI 连接选择可用的模型变体，无需更改现有集成。 **清晰的用量价格** 发送请求前查看目录中的当前价格，无需订阅或最低消费。 **自动化任务流程** 通过一致的任务流程提交任务、查询状态并收集异步结果，无需编写手动轮询代码。 ## OpenClaw + HeyGen Video 常见问题 ### HeyGen Video API 的模型 ID 是什么？ 把 model 的值设为 heygen-video-1。文生视频端点接收提示词以及可选的参考图片、视频或音频；图生视频端点接收提示词和首帧图像。 ### HeyGen Video 支持哪些输入方式？ 支持文本提示词、首帧图像，以及参考图片、视频和音频。输出为 5 到 15 秒，分辨率可选 480p、768p、1080p 或 2K，并包含生成的声音。 ### HeyGen Video 会生成声音吗？ 会。对白、环境音和音效与视频在同一次请求中生成。 ### HeyGen Video 在 RunAPI 上如何计费？ 按视频秒数计费。本页的价格表列出了每种分辨率和输入类型的当前费率，生成失败不计费。 ### 这是 HeyGen 的数字人（avatar）API 吗？ 不是。HeyGen Video 是 HeyGen 的通用视频模型，根据提示词或图片生成包含声音在内的完整画面。由脚本和所选声音生成的数字人口播视频，来自 HeyGen 另外提供的 avatar API，RunAPI 不提供该 API。 ### 应该使用哪个模型 ID？ 从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。 ### 本指南会配置聊天模型吗？ 不会。该 Model Line 使用页面所示的端点流程，不会被描述为 Agent 聊天模型。 ## 更多 OpenClaw 指南 - [OpenClaw x Claude](https://runapi.ai/zh-CN/openclaw-claude.md) - Anthropic · 文本 · 起价 $0.08 / 百万 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.03 / 1K 个字符 - [OpenClaw x Embedding](https://runapi.ai/zh-CN/openclaw-embedding.md) - OpenAI · 文本 · 起价 $0.02 / 百万 tokens ## 开始在 OpenClaw 中使用 HeyGen Video - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读快速开始](https://runapi.ai/zh-CN/docs/guides) ## 需要团队接入支持？ 我们可以协助团队接入、完成系统集成并解答技术问题。 [联系我们](https://runapi.ai/zh-CN/contact.md) --- ## 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 HeyGen Video", "applicationCategory": "DeveloperApplication", "description": "通过 RunAPI 在 OpenClaw 中使用 HeyGen Video。比较当前模型 ID、端点与价格，然后按对应流程完成配置。", "url": "https://runapi.ai/zh-CN/openclaw-heygen-video" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "HeyGen Video API 的模型 ID 是什么？", "acceptedAnswer": { "@type": "Answer", "text": "把 model 的值设为 heygen-video-1。文生视频端点接收提示词以及可选的参考图片、视频或音频；图生视频端点接收提示词和首帧图像。" } }, { "@type": "Question", "name": "HeyGen Video 支持哪些输入方式？", "acceptedAnswer": { "@type": "Answer", "text": "支持文本提示词、首帧图像，以及参考图片、视频和音频。输出为 5 到 15 秒，分辨率可选 480p、768p、1080p 或 2K，并包含生成的声音。" } }, { "@type": "Question", "name": "HeyGen Video 会生成声音吗？", "acceptedAnswer": { "@type": "Answer", "text": "会。对白、环境音和音效与视频在同一次请求中生成。" } }, { "@type": "Question", "name": "HeyGen Video 在 RunAPI 上如何计费？", "acceptedAnswer": { "@type": "Answer", "text": "按视频秒数计费。本页的价格表列出了每种分辨率和输入类型的当前费率，生成失败不计费。" } }, { "@type": "Question", "name": "这是 HeyGen 的数字人（avatar）API 吗？", "acceptedAnswer": { "@type": "Answer", "text": "不是。HeyGen Video 是 HeyGen 的通用视频模型，根据提示词或图片生成包含声音在内的完整画面。由脚本和所选声音生成的数字人口播视频，来自 HeyGen 另外提供的 avatar API，RunAPI 不提供该 API。" } }, { "@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 中使用 HeyGen Video", "step": [ { "@type": "HowToStep", "position": 1, "name": "选择模型 ID", "text": "选择公开模型 ID，并查看其端点与当前起步价格。", "url": "https://runapi.ai/zh-CN/openclaw-heygen-video#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "配置 RunAPI", "text": "调用端点前设置 RUNAPI_API_KEY。", "url": "https://runapi.ai/zh-CN/openclaw-heygen-video#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "验证结果", "text": "对于异步端点，轮询同一端点，直到 Task 进入终态。", "url": "https://runapi.ai/zh-CN/openclaw-heygen-video#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": "HeyGen Video", "item": "https://runapi.ai/zh-CN/openclaw-heygen-video" } ] } ] ```