公开版本与端点
| 模型 ID | 端点 | 起步价格 | 模型目录 |
|---|---|---|---|
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/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。配置
指南端点: /api/v1/heygen_video/text_to_video
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"
}'
使用流程
三步开始使用
-
选择模型 ID
选择公开模型 ID，并查看其端点与当前起步价格。
-
配置 RunAPI
调用端点前设置 RUNAPI_API_KEY。
-
验证结果
对于异步端点，轮询同一端点，直到 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 聊天模型。