介绍
# HeyGen API
AI 虚拟人视频创建 API，用于生成对话式头部视频、解说视频和演示文稿。
## 默认工作流
对于大多数视频请求，**优先使用 Video Agent API** (`POST /v1/video_agent/generate`)。 请始终遵循 [prompt-optimizer.md](references/prompt-optimizer.md) 中的指南，使用场景、时长和视觉风格来构建提示词。
仅当用户明确需要以下功能时才使用 v2/video/generate： - 不经 AI 修改的精确脚本 - 指定 voice_id 选择 - 每个场景不同的虚拟人/背景 - 精确的逐场景时长控制 - 具有精确规范的程序化/批量生成
## 快速参考
| 任务 | 阅读 | |------|------| | 通过提示词生成视频（简单） | [prompt-optimizer.md](references/prompt-optimizer.md) → [video-agent.md](references/video-agent.md) | | 精确控制生成视频 | [video-generation.md](references/video-generation.md), [avatars.md](references/avatars.md), [voices.md](references/voices.md) | | 检查视频状态 / 获取下载链接 | [video-status.md](references/video-status.md) | | 添加字幕或文字叠加 | [captions.md](references/captions.md), [text-overlays.md](references/text-overlays.md) | | 用于合成的透明视频 | [video-generation.md](references/video-generation.md) (WebM 部分) | | 生成独立的 TTS 音频 | [text-to-speech.md](references/text-to-speech.md) | | 翻译/配音现有视频 | [video-translation.md](references/video-translation.md) | | 结合 Remotion 使用 | [remotion-integration.md](references/remotion-integration.md) |
## 参考文件
### 基础 - [references/authentication.md](references/authentication.md) - API 密钥设置和 X-Api-Key 请求头 - [references/quota.md](references/quota.md) - 点数系统和使用限制 - [references/video-status.md](references/video-status.md) - 轮询模式和下载链接 - [references/assets.md](references/assets.md) - 上传图片、视频、音频
### 核心视频创建 - [references/avatars.md](references/avatars.md) - 列出虚拟人、样式、avatar_id 选择 - [references/voices.md](references/voices.md) - 列出声音、语言区域、语速/音调 - [references/scripts.md](references/scripts.md) - 编写脚本、停顿、节奏 - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate 和多场景视频 - [references/video-agent.md](references/video-agent.md) - 单次提示词视频生成 - [references/prompt-optimizer.md](references/prompt-optimizer.md) - 撰写有效的 Video Agent 提示词 - [references/dimensions.md](references/dimensions.md) - 分辨率和纵横比
### 视频自定义 - [references/backgrounds.md](references/backgrounds.md) - 纯色、图片、视频背景 - [references/text-overlays.md](references/text-overlays.md) - 添加带字体和定位的文字 - [references/captions.md](references/captions.md) - 自动生成的字幕和副标题
### 高级功能 - [references/templates.md](references/templates.md) - 模板列表和变量替换 - [references/video-translation.md](references/video-translation.md) - 视频翻译和配音 - [references/text-to-speech.md](references/text-to-speech.md) - 使用 Starfish 模型的独立 TTS 音频 - [references/photo-avatars.md](references/photo-avatars.md) - 从照片创建虚拟人 - [references/webhooks.md](references/webhooks.md) - Webhook 端点和事件
### 集成 - [references/remotion-integration.md](references/remotion-integration.md) - 在 Remotion 组成中使用 HeyGen