create-video

用途

Create Video 用于从一段文字提示词生成完整视频。适用情形包括：根据一段描述或点子的视频创作，以及生成讲解类、演示类视频。描述你想要的画面，AI 会负责脚本撰写、数字人选择、视觉画面、配音、节奏把控和字幕添加。

主要能力与调用方式

技能通过 HeyGen 的 Video Agent 提供视频生成能力，包含以下任务与对应调用：

从提示词生成视频：MCP 工具 mcp__heygen__generate_video_agent，回退方案为直接调用 POST /v1/video_agent/generate
查询视频状态 / 获取 URL：MCP 工具 mcp__heygen__get_video，回退方案为 GET /v2/videos/{video_id}
列出账户下的视频：MCP 工具 mcp__heygen__list_videos，回退方案为 GET /v2/videos
删除视频：MCP 工具 mcp__heygen__delete_video，回退方案为 DELETE /v2/videos/{video_id}

如果环境中存在 HeyGen MCP 工具（mcp__heygen__*），应优先使用它们而非直接 HTTP API 调用——它们会自动处理认证和请求格式化。若没有可用的 HeyGen MCP 工具，则按参考文件中的说明使用直接 HTTP API 调用。

认证

所有请求都需要 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": "Create a 60-second product demo video."}'

默认工作流

始终使用 prompt-optimizer.md 的规范来组织提示词，包含场景、时间点和视觉风格。

使用 MCP 工具时：

按照 prompt-optimizer.md → visual-styles.md 编写优化后的提示词
调用 mcp__heygen__generate_video_agent，传入 prompt 与 config（duration_sec、orientation、avatar_id）
使用返回的 video_id 调用 mcp__heygen__get_video 轮询状态并获取下载 URL

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

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

快速参考

从提示词生成视频：MCP 工具 mcp__heygen__generate_video_agent，阅读顺序 prompt-optimizer.md → visual-styles.md → video-agent.md
查询视频状态 / 获取下载 URL：MCP 工具 mcp__heygen__get_video，阅读 video-status.md
为提示词上传参考文件：通过 assets.md

何时使用本技能，何时使用 Avatar Video

本技能用于基于提示词的视频创作——描述你想要的内容，AI 负责其余部分。

如果用户需要对特定数字人、精确脚本、逐场景的语音/背景配置或多场景合成进行精准控制，则应改用 avatar-video 技能。

用户表述与技能对应：

“给我做一个关于 X 的视频”——本技能
“创建一个产品演示”——本技能
“我想让数字人 Y 说出确切的 Z”——Avatar Video 技能
“带不同背景的多场景视频”——Avatar Video 技能
“用于合成的透明 WebM”——Avatar Video 技能

参考文件

核心工作流：

references/prompt-optimizer.md —— 编写有效的提示词（核心工作流 + 规则）
references/visual-styles.md —— 20 种命名视觉风格及其完整规范
references/prompt-examples.md —— 完整的生产级提示词示例 + 可直接使用的模板
references/video-agent.md —— Video Agent API 端点细节

基础内容：

references/video-status.md —— 轮询模式与下载 URL
references/webhooks.md —— Webhook 端点与事件
references/assets.md —— 上传图片、视频、音频作为参考
references/dimensions.md —— 分辨率与宽高比
references/quota.md —— 积分系统与使用限额

最佳实践

优化提示词——平庸与专业结果之间的差异完全取决于提示词质量，务必使用提示词优化器
指定时长——使用 config.duration_sec 以获得可预测的长度
按需锁定数字人——需要多视频一致性时使用 config.avatar_id
上传参考文件——帮助 agent 理解你的品牌/产品
迭代提示词——根据结果加以优化；Video Agent 非常适合快速迭代

限制与未提供信息

资料未提供具体定价、各平台支持情况、生成耗时保证或额度数值等细节，相关事实暂未提供。