统一认证,接入所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
通过 RunAPI 使用 HeyGen Video API,配套 model skill、统一认证和按需计费。
curl -X POST https://runapi.ai/api/v1/heygen_video/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "生成一段 10 秒 1080p 的产品视频:阳光照进的厨房台面上放着一只陶瓷马克杯,使用参考图片保持杯子设计一致,并加入轻柔的环境音。"
}'
import { HeygenVideoClient } from "@runapi.ai/heygen-video";
const client = new HeygenVideoClient();
const result = await client.imageToVideo.run({
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 10 秒 1080p 的产品视频:阳光照进的厨房台面上放着一只陶瓷马克杯,使用参考图片保持杯子设计一致,并加入轻柔的环境音。",
});
require "runapi/heygen_video"
client = RunApi::HeygenVideo::Client.new
result = client.image_to_video.run(
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 10 秒 1080p 的产品视频:阳光照进的厨房台面上放着一只陶瓷马克杯,使用参考图片保持杯子设计一致,并加入轻柔的环境音。"
)
npx skills add runapi-ai/heygen-video -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
HeyGen Video API(模型 ID 为 heygen-video-1)可生成 5 到 15 秒的视频,并在同一次请求中生成对白、环境音和音效。可从文本提示词生成,动画化首帧图像,也可用参考图像、视频和音频保持产品、人物和场景一致。
| 模型 ID | heygen-video-1 |
| 提供方 | HeyGen |
| 模态 | video |
| 任务类型 | asynchronous |
| 计费单位 | 秒 |
| API 端点 | /api/v1/heygen_video/image_to_video |
| 商用许可 | 允许商用 |
| 收录状态 | 运行中 |
根据输出类型、质量要求和延迟目标选择模型与变体。
设置 RunAPI key,并在代码工作区安装对应 model skill。
按 skill 里的说明,把模型能力接入到你的应用里。
按 task ID 轮询、在支持时使用流式,或处理 webhook 回调。
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
USD 按次定价,按月结算。失败的生成不计费。
Typed schema 和接入说明已打包进 model skill,让实现从正确契约开始。
把 model 的值设为 heygen-video-1。文生视频端点接收提示词以及可选的参考图片、视频或音频;图生视频端点接收提示词和首帧图像。
支持文本提示词、首帧图像,以及参考图片、视频和音频。输出为 5 到 15 秒,分辨率可选 480p、768p、1080p 或 2K,并包含生成的声音。
会。对白、环境音和音效与视频在同一次请求中生成。
按视频秒数计费。本页的价格表列出了每种分辨率和输入类型的当前费率,生成失败不计费。
不是。HeyGen Video 是 HeyGen 的通用视频模型,根据提示词或图片生成包含声音在内的完整画面。由脚本和所选声音生成的数字人口播视频,来自 HeyGen 另外提供的 avatar API,RunAPI 不提供该 API。
选满足质量要求的最便宜变体。多数团队从 fast 起步,生产时升级到 pro。