名称： heygen
描述： |
HeyGen AI 视频生成 API。适用于以下场景：(1) 使用视频智能体进行单次提示词到视频的生成，(2) 使用 /v2/video/generate 生成 AI 数字人视频，(3) 处理 HeyGen 的数字人、语音、背景或字幕，(4) 创建用于合成的透明 WebM 视频，(5) 轮询视频状态或处理 Webhook，(6) 将 HeyGen 与 Remotion 集成以实现程序化视频生成，(7) 翻译或为现有视频配音，(8) 通过 /v1/audio 使用 Starfish 模型生成独立的 TTS 音频。
主页： https://docs.heygen.com/reference/generate-video-agent
元数据：
openclaw:
requires:
env:
- HEYGEN_API_KEY
primaryEnv: HEYGEN_API_KEY

HeyGen API

用于生成口播视频、讲解视频和演示文稿的 AI 数字人视频生成 API。

默认工作流

对于大多数视频生成请求，优先使用视频智能体 API (POST /v1/video_agent/generate)。
务必遵循 prompt-optimizer.md 中的指南来构建提示词，包含场景、时长和视觉风格。

仅当用户明确需要以下功能时，才使用 v2/video/generate：
- 无需 AI 修改的精确脚本
- 选择特定的语音 ID (voice_id)
- 每个场景使用不同的数字人/背景
- 精确的逐场景时长控制
- 基于精确规格的程序化/批量生成

快速参考

参考文件

基础

• references/authentication.md - API 密钥设置与 X-Api-Key 请求头
• references/quota.md - 积分系统与使用限制
• references/video-status.md - 轮询模式与下载链接
• references/assets.md - 上传图片、视频、音频

核心视频生成

• references/avatars.md - 数字人列表、风格、avatar_id 选择
• references/voices.md - 语音列表、语言区域、语速/音调
• references/scripts.md - 脚本撰写、停顿、节奏
• references/video-generation.md - POST /v2/video/generate 与多场景视频
• references/video-agent.md - 单次提示词视频生成
• references/prompt-optimizer.md - 撰写高效的视频智能体提示词（核心工作流 + 规则）
• references/visual-styles.md - 20 种带完整规格的命名视觉风格
• references/prompt-examples.md - 完整生产级提示词示例 + 开箱即用模板
• references/dimensions.md - 分辨率与宽高比

视频定制

• references/backgrounds.md - 纯色、图片、视频背景
• references/text-overlays.md - 添加带字体和定位的文字
• references/captions.md - 自动生成的字幕

高级功能

• references/templates.md - 模板列表与变量替换
• references/video-translation.md - 视频翻译与配音
• references/text-to-speech.md - 使用 Starfish 模型生成独立的 TTS 音频
• references/photo-avatars.md - 从照片创建数字人
• references/webhooks.md - Webhook 端点与事件

集成

• references/remotion-integration.md - 在 Remotion 合成中使用 HeyGen