视频 HeyGen

HeyGen Video API

通过 RunAPI 使用 HeyGen Video API,配套 model skill、统一认证和按需计费。

runapi.ai
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
@runapi.ai/heygen-video v1
概览

关于 HeyGen Video

HeyGen Video API(模型 ID 为 heygen-video-1)可生成 5 到 15 秒的视频,并在同一次请求中生成对白、环境音和音效。可从文本提示词生成,动画化首帧图像,也可用参考图像、视频和音频保持产品、人物和场景一致。

提供方
HeyGen
模态
视频
定价

定价

失败的生成不计费
文生视频
$0.04-$0.36 / 秒
计费输入模式:standard · 输出分辨率:2k $0.18
计费输入模式:standard · 输出分辨率:480p $0.04
计费输入模式:standard · 输出分辨率:768p $0.06
计费输入模式:standard · 输出分辨率:1080p $0.18
计费输入模式:reference · 输出分辨率:2k $0.36
计费输入模式:reference · 输出分辨率:480p $0.08
计费输入模式:reference · 输出分辨率:768p $0.12
计费输入模式:reference · 输出分辨率:1080p $0.36
图生视频
$0.02-$0.09 / 秒
输出分辨率:2k $0.09
输出分辨率:480p $0.02
输出分辨率:768p $0.03
输出分辨率:1080p $0.09
规格

技术细节

模型 ID heygen-video-1
提供方 HeyGen
模态 video
任务类型 asynchronous
计费单位 秒
API 端点 /api/v1/heygen_video/image_to_video
商用许可 允许商用
收录状态 运行中
Agent 集成

通过 Agent 运行 HeyGen Video

工作流程

开始使用 HeyGen Video

  1. 选择模型

    根据输出类型、质量要求和延迟目标选择模型与变体。

  2. 配置

    设置 RunAPI key,并在代码工作区安装对应 model skill。

  3. 调用

    按 skill 里的说明,把模型能力接入到你的应用里。

  4. 接收

    按 task ID 轮询、在支持时使用流式,或处理 webhook 回调。

背景

HeyGen Video API 是什么?

文生视频、图生视频和参考引导生成共用一个 RunAPI 模型 ID。输出分辨率为 480p 至 2K;参考模式最多支持 9 张图片、3 段视频和 3 段音频,参考文件总数不超过 12 个。

提供方
HeyGen
查看全部 →
模态
视频
浏览模型 →

为什么用 RunAPI 调用 HeyGen Video API

统一认证,接入所有提供方

一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。

统一的定价与账单

USD 按次定价,按月结算。失败的生成不计费。

Schema 优先的 SDK

Typed schema 和接入说明已打包进 model skill,让实现从正确契约开始。

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。

应该从哪个变体开始?

选满足质量要求的最便宜变体。多数团队从 fast 起步,生产时升级到 pro。

相似模型

如果喜欢 HeyGen Video API,也可以试试这些

立即体验 HeyGen Video API。

Endpoints

  • text_to_video
  • image_to_video

同类

同提供方

文档