用途：根据文本提示词生成完整视频，AI 自动处理脚本撰写、数字人选择、画面、配音、节奏与字幕，是多数视频请求的默认方式。
主要能力：支持通过提示词生成视频、查询视频状态与下载地址、列出账号视频、删除视频。可指定时长、画面方向、avatar_id 保持数字人一致、voice_id 指定旁白音色，并可上传图片、视频、音频作为参考素材。
使用方式：所有请求需 X-Api-Key 请求头，设置 HEYGEN_API_KEY 环境变量。若存在 HeyGen MCP 工具（mcp__heygen__*），优先使用，可自动处理认证与请求格式；否则直接调用 HTTP API。生成视频用 POST /v3/video-agents，查询状态用 GET /v3/videos/{video_id}，列表用 GET /v3/videos，删除用 DELETE /v3/videos/{video_id}。示例：curl -X POST "https://api.heygen.com/v3/video-agents" -H "X-Api-Key: $HEYGEN_API_KEY" -H "Content-Type: application/json" -d '{"prompt": "Create a 60-second product demo video."}'。
推荐流程：先用 prompt-optimizer.md 与 visual-styles.md 编写含场景、时间与视觉风格的优化提示词，再调用生成接口，随后轮询状态获取下载地址。参考文件涵盖提示词优化、20 种视觉风格、提示词示例、接口字段、状态轮询、Webhook、素材上传、分辨率与宽高比、额度限制。
适用场景：产品演示、营销短视频、需要数字人出镜或快速迭代的视频草稿。
限制：质量高度依赖提示词结构，建议始终使用提示词优化器；具体收费、价格与额度细节暂未提供。