🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx skills add https://skills.sh/heygen-com/skills/create-video

💡 提示：需要 Node.js 和 NPM

创建视频

根据文本提示生成完整的视频。描述你的需求，AI 会自动处理脚本编写、虚拟形象选择、视觉效果、配音、节奏和字幕。

身份验证

所有请求都需要 X-Api-Key 请求头。设置 HEYGEN_API_KEY 环境变量。

curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "创建一个 60 秒的产品演示视频。"}'

工具选择

如果 HeyGen MCP 工具可用（mcp__heygen__*），优先使用它们，而不是直接使用 HTTP API 调用 —— 它们会自动处理身份验证和请求格式。

任务 MCP 工具 备用方案（直接 API）
根据提示生成视频 mcp__heygen__generate_video_agent POST /v1/video_agent/generate
检查视频状态 / 获取 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}

如果没有可用的 HeyGen MCP 工具，则使用参考文件中记录的 HTTP API 直接调用。

默认工作流程

始终使用 prompt-optimizer.md 指南来构建包含场景、时长和视觉风格的提示词。

使用 MCP 工具：

  1. 使用 prompt-optimizer.md → visual-styles.md 编写优化的提示词
  2. 使用提示词和配置（时长、方向、虚拟形象 ID）调用 mcp__heygen__generate_video_agent
  3. 使用返回的 video_id 调用 mcp__heygen__get_video 轮询状态并获取下载 URL

不使用 MCP 工具（直接 API）：

  1. 使用 prompt-optimizer.md → visual-styles.md 编写优化的提示词
  2. POST /v1/video_agent/generate — 参见 video-agent.md
  3. GET /v2/videos/<id> — 参见 video-status.md

快速参考

任务 MCP 工具 参考资料
根据提示生成视频 mcp__heygen__generate_video_agent prompt-optimizer.md → visual-styles.md → video-agent.md
检查视频状态 / 获取下载 URL mcp__heygen__get_video video-status.md
上传参考文件用于提示 — assets.md

何时使用此技能 vs 虚拟形象视频技能

此技能适用于基于提示的视频创作 —— 描述你想要的内容，AI 会处理其余部分。

如果用户需要对特定虚拟形象、精确脚本、每个场景的语音/背景配置或多场景合成进行精确控制，则应使用 avatar-video 技能。

用户说 此技能 虚拟形象视频技能
“帮我制作一个关于 X 的视频” ✓
“创建一个产品演示” ✓
“我想要虚拟形象 Y 准确说出 Z” ✓
“具有不同背景的多场景视频” ✓
“用于合成的透明 WebM” ✓

参考文件

核心工作流

基础

最佳实践

  1. 优化提示词 — 平庸与专业结果之间的差异完全取决于提示词的质量。始终使用提示词优化器
  2. 指定时长 — 使用 config.duration_sec 以获得可预测的长度
  3. 必要时锁定虚拟形象 — 使用 config.avatar_id 确保视频间的一致性
  4. 上传参考文件 — 帮助代理理解你的品牌/产品
  5. 迭代优化提示词 — 根据结果进行优化；视频代理非常适合快速迭代

📄 原始文档

完整文档（英文）：

https://skills.sh/heygen-com/skills/create-video

💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。