🚀 快速安装
复制以下命令并运行，立即安装此 Skill：
npx skills add https://skills.sh/heygen-com/skills/avatar-video💡 提示：需要 Node.js 和 NPM
数字人视频 (Avatar Video)
创建具有完全控制权的 AI 数字人视频，包括数字人形象、声音、脚本、场景和背景。使用 HeyGen 的 /v2/video/generate API 构建单场景或多场景视频并进行精确配置。
认证 (Authentication)
所有请求都需要 X-Api-Key 请求头。请设置 HEYGEN_API_KEY 环境变量。
curl -X GET "https://api.heygen.com/v2/avatars" \
-H "X-Api-Key: $HEYGEN_API_KEY"
工具选择 (Tool Selection)
如果 HeyGen MCP 工具可用（mcp__heygen__*），优先使用它们而不是直接的 HTTP API 调用——它们会自动处理认证和请求格式。
| 任务 (Task) | MCP 工具 (MCP Tool) | 备用方案（直接 API）(Fallback – Direct API) |
|---|---|---|
| 检查视频状态 / 获取 URL | mcp__heygen__get_video |
GET /v2/videos/{video_id} |
| 列出账户视频 | mcp__heygen__list_videos |
GET /v2/videos |
| 删除视频 | mcp__heygen__delete_video |
DELETE /v2/videos/{video_id} |
视频生成（POST /v2/video/generate）以及数字人形象/声音列表通过直接 API 调用完成——请参见下面的参考文件。
默认工作流 (Default Workflow)
- 列出数字人形象 (List avatars) —
GET /v2/avatars→ 选择一个数字人形象，预览它，记下avatar_id和default_voice_id。参见 avatars.md - 列出声音 (List voices) （如果需要）—
GET /v2/voices→ 选择一个与数字人形象性别/语言匹配的声音。参见 voices.md - 编写脚本 (Write the script) — 每个场景构建一个概念。参见 scripts.md
- 生成视频 (Generate the video) — 使用
POST /v2/video/generate，为每个场景配置数字人形象、声音、脚本和背景。参见 video-generation.md - 轮询直至完成 (Poll for completion) —
GET /v2/videos/{video_id}直到状态变为completed。参见 video-status.md
快速参考 (Quick Reference)
| 任务 (Task) | 阅读 (Read) |
|---|---|
| 列出和预览数字人形象 | avatars.md |
| 列出和选择声音 | voices.md |
| 编写和构建脚本 | scripts.md |
| 生成视频（单场景或多场景） | video-generation.md |
| 添加自定义背景 | backgrounds.md |
| 添加字幕 | captions.md |
| 添加文字叠加 | text-overlays.md |
| 创建透明 WebM 视频 | video-generation.md（WebM 部分） |
| 使用模板 | templates.md |
| 从照片创建数字人形象 | photo-avatars.md |
| 检查视频状态 / 下载 | video-status.md |
| 上传素材（图片、音频） | assets.md |
| 与 Remotion 集成使用 | remotion-integration.md |
| 设置 webhook | webhooks.md |
何时使用此技能 vs. 创建视频技能 (When to Use This Skill vs Create Video)
此技能适用于精确控制——您选择数字人形象、编写精确脚本、配置每个场景。
如果用户只想描述一个视频创意，让 AI 处理其余部分（脚本、数字人形象、视觉效果），请改用 create-video 技能。
| 用户说 (User Says) | 创建视频技能 (Create Video Skill) | 此技能 (This Skill) |
|---|---|---|
| “给我做一个关于 X 的视频” | ✓ | |
| “创建一个产品演示” | ✓ | |
| “我希望数字人形象 Y 确切地说 Z” | ✓ | |
| “具有不同背景的多场景视频” | ✓ | |
| “用于合成的透明 WebM” | ✓ | |
| “为我的脚本使用这个特定的声音” | ✓ | |
| “批量生成具有精确规格的视频” | ✓ |
参考文件 (Reference Files)
核心视频创建 (Core Video Creation)
- references/avatars.md – 列出数字人形象、样式、avatar_id 选择
- references/voices.md – 列出声音、语言、语速/音调
- references/scripts.md – 编写脚本、停顿、节奏
- references/video-generation.md – POST /v2/video/generate 和多场景视频
视频定制 (Video Customization)
- references/backgrounds.md – 纯色、图片、视频背景
- references/text-overlays.md – 添加带字体和位置的文字
- references/captions.md – 自动生成字幕
高级功能 (Advanced Features)
- references/templates.md – 模板列表和变量替换
- references/photo-avatars.md – 从照片创建数字人形象
- references/webhooks.md – Webhook 端点和事件
集成 (Integration)
- references/remotion-integration.md – 在 Remotion 组件中使用 HeyGen
基础 (Foundation)
- references/video-status.md – 轮询模式和下载 URL
- references/assets.md – 上传图片、视频、音频
- references/dimensions.md – 分辨率和宽高比
- references/quota.md – 信用点系统和用量限制
最佳实践 (Best Practices)
- 在生成前预览数字人形象 (Preview avatars before generating) — 下载
preview_image_url，以便用户在确认前看到数字人形象 - 使用数字人形象的默认声音 (Use avatar’s default voice) — 大多数数字人形象都有预匹配的
default_voice_id，以获得自然效果 - 备用方案：手动匹配性别 (Fallback: match gender manually) — 如果没有默认声音，确保数字人形象和声音性别匹配
- 使用测试模式进行开发 (Use test mode for development) — 设置
test: true以避免消耗信用点（输出将带有水印） - 设置充足的超时时间 (Set generous timeouts) — 视频生成通常需要 5-15 分钟，有时更长
- 验证输入 (Validate inputs) — 在生成前检查数字人形象 ID 和声音 ID 是否存在
📄 原始文档
完整文档（英文）：
https://skills.sh/heygen-com/skills/avatar-video
💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。
评论(0)