name: HeyGen 自动化 description: “通过Composio在HeyGen平台上自动化AI视频生成、头像浏览、基于模板的视频创建和视频状态跟踪” requires: mcp: - rube
HeyGen 自动化
自动化AI驱动的视频创建工作流——浏览头像和模板，从模板生成个性化视频，跟踪处理状态，并获取可分享URL——全部通过Composio MCP集成编排。
工具包文档: composio.dev/toolkits/heygen
设置
- 通过Composio MCP服务器在
https://rube.app/mcp连接您的HeyGen账户 - 如果没有活动连接，代理将提示您一个认证链接
- 一旦连接，所有
HEYGEN_*工具变得可用执行
核心工作流
1. 浏览可用模板
从HeyGen库中检索预设计的头像模板以用于视频创建。
工具: HEYGEN_V2_TEMPLATES
无需参数——返回模板ID、名称、预览图像和自定义选项。
使用此功能在生成视频前发现模板。每个模板都有一个生成所需的唯一ID。
2. 检查模板详情和变量
检索模板的完整结构，包括所有变量、场景映射和自定义选项。
工具: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
template_id |
字符串 | 是 | 来自 HEYGEN_V2_TEMPLATES 或HeyGen仪表板的模板ID |
这是生成视频前的必需先决条件——它确切告诉您哪些变量必须填充。
3. 浏览可用头像
列出所有可用于视频创建的逼真头像，用于将角色映射到场景。
工具: HEYGEN_V2_AVATARS
无需参数——返回头像标识符、名称和预览图像。
列表可能分页；可能需要额外调用以获取完整集合。
4. 从模板生成视频
通过用您的变量和内容填充模板来创建自定义视频。
工具: HEYGEN_V2_TEMPLATE_GENERATE
提供视频标题和通过 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 发现的所有模板变量。每个必需变量必须以确切的名称和类型提供。
5. 检查视频处理状态
轮询处理状态并检索正在生成的视频的元数据。
工具: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
video_id |
字符串 | 是 | 从生成API返回的视频ID |
返回的URL在7天后过期，但可以通过再次调用此端点重新生成。
6. 获取可分享视频URL
生成一个公共、可分享的链接，允许任何人无需认证查看视频。
工具: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
提供 video_id 以接收用于分发的公共URL。
已知陷阱
| 陷阱 | 详情 |
|---|---|
| 所有模板变量必需 | HEYGEN_V2_TEMPLATE_GENERATE 要求来自 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 的每个变量具有确切名称和类型——缺失或错误命名字段会破坏场景或导致生成失败 |
| 始终先检查模板 | 在生成前切勿跳过 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3——多场景模板有复杂的变量结构 |
| 视频URL过期 | 来自 HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS 的URL在7天后过期；通过再次调用端点重新生成 |
| 分页的头像列表 | HEYGEN_V2_AVATARS 可能返回分页结果——可能需要额外调用以获取完整库 |
| 处理时间变化 | 视频生成是异步的；轮询 HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS 直到状态完成再使用输出URL |
快速参考
| 工具标识 | 目的 |
|---|---|
HEYGEN_V2_TEMPLATES |
列出可用视频模板 |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 |
获取模板变量和场景结构 |
HEYGEN_V2_AVATARS |
浏览可用AI头像 |
HEYGEN_V2_TEMPLATE_GENERATE |
从模板生成视频 |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS |
检查视频处理状态并获取URL |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL |
获取公共可分享视频链接 |
由 Composio 提供支持