如何通过 MCP 将 HeyGen 连接到 ChatGPT

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → HeyGen、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

HeyGen + ChatGPT

让你的 AI 用你自己的密钥制作 HeyGen 数字人视频：选择数字人和声音，把脚本或提示变成口播视频，填充你的模板，把视频翻译成其他语言并对口型，创建照片数字人，并查看渲染进度和你的余额。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

HEYGEN_API_KEY

步骤 1 — 获取凭证

1. 登录 https://app.heygen.com，打开 API 控制台（https://app.heygen.com/developers/api）。
2. 生成一个 API 密钥并复制。API 用量与 HeyGen 网页版订阅分开计费：如果账户还没有余额或付款方式，请在那里充值或添加。
3. 将密钥粘贴到 HEYGEN_API_KEY，然后安装连接器。密钥只会发送给 HeyGen。如果密钥只限定了部分权限范围，则需要对数字人、声音、视频、模板、翻译和用户的读取权限，以及创建类工具所需的写入权限。
4. 先使用 heygen_get_account：它会显示你的计费类型以及剩余可用额度。

从你的 HeyGen API 余额中扣费：视频、翻译和数字人都从你的 API 余额中支付（按量付费钱包或套餐积分）。HeyGen 按视频时长和引擎计费；当前价格见 API 控制台，被拒绝的调用（402）会说明所需金额。列出和查询均免费。

先确认：在调用 heygen_create_video、heygen_generate_from_template、heygen_create_agent_video 或 heygen_translate_video 之前，AI 会告诉你将要制作的内容（数字人、声音、脚本长度、格式、语言、引擎），并等你确认。heygen_create_photo_avatar 只接受本人同意使用的照片（例如你自己的照片），AI 会请你确认你拥有这项权利。heygen_delete_video 在安装时默认关闭。

视频的制作过程：

1. AI 用 heygen_list_avatar_groups 选择一个角色，再用 heygen_list_avatar_looks 选择它的一个形象；这个形象就是出镜的主持人。可以选择 heygen_list_voices 中的声音，否则使用数字人自带的声音。
2. heygen_create_video 接收脚本（最多 5,000 个字符）、格式（例如短视频用 9:16）和引擎，并立即返回一个视频 id。
3. 视频在后台渲染。AI 大约每 30 秒查询一次 heygen_get_video；渲染需要一分钟到几分钟，脚本较长时更久。
4. 完成的视频附带 MP4 链接、带字幕的版本、SRT 字幕，以及该视频在 HeyGen 中的链接。下载链接会过期；需要时再请求新的链接即可。

制作视频的其他方式：

• 模板：heygen_list_templates 和 heygen_get_template 显示可通过 API 使用的模板及其变量；heygen_generate_from_template 填入所有文本变量并渲染视频。
• Video Agent：heygen_create_agent_video 把一个提示变成完整的视频（脚本、场景、数字人）；heygen_get_agent_session 跟踪进度，直到视频渲染完成。
• 翻译：heygen_translate_video 把公开链接中的视频翻译成一种或多种语言，可使用说话人的克隆声音并对口型，也可只翻译音频；heygen_list_translation_languages 列出可选的目标语言。
• 照片数字人：heygen_create_photo_avatar 用一张人像照片制作主持人；heygen_get_avatar_look 显示它何时可以使用。

引擎：avatar_iv 为默认引擎。avatar_v 动作最自然，但仅适用于支持它的形象。avatar_iii 支持数字分身和影棚数字人的 4K 输出。

限制：按量付费时最多同时渲染 10 个视频、翻译或代理会话（Enterprise 更多），列表调用每分钟 300 次，状态查询每分钟 500 次。源文件必须是公开链接：视频最大 100 MB，音频最大 50 MB 且不超过 10 分钟。

常见错误：401：密钥错误或已撤销。402 insufficient_credit：余额不足以支付此视频，错误信息会说明所需金额。usage_limit_reached 或 trial_limit_exceeded：达到工作区或试用限制，需要管理员或付费套餐解除。403 insufficient_api_key_scope：密钥权限受限；请为它授予上面列出的权限范围。400 invalid_parameter：错误信息会指出具体字段，例如该形象不支持的引擎。404：id 不存在；AI 会用列表工具核对。429：请求过多；请稍后重试一次。

该连接器使用 HeyGen 的 API v3（HeyGen 将于 2026 年 10 月 31 日停用旧的 v1 和 v2 端点）。它不支持多场景影棚视频、图片转视频、为已有视频对口型、声音克隆和声音设计、单独的文本转语音、交互式流媒体数字人、文件上传（源文件必须是公开链接）、翻译校对、webhook、品牌套件、文件夹或批量处理。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 ChatGPT 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件，仅付费套餐可用，不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。

1. 前往 chatgpt.com/plugins，点击 +，然后选择 Add custom MCP server。
2. 填写名称，例如 Name: HeyGen。
3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。
4. 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
5. 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。

可用工具

示例提示

• “我的 HeyGen API 余额还剩多少？”
• “给我看我自己的数字人，以及它们的哪些形象最适合 9:16。”
• “用我的数字分身朗读这段脚本，制作一个 45 秒的 9:16 视频。先和我确认数字人、声音和时长，渲染完成后把 MP4 链接发给我。”
• “用这三条新闻填充我们的每周更新模板并渲染。”
• “把这段产品演示视频翻译成西班牙语（西班牙）和日语并对口型，两个版本都完成后通知我。”

FAQ

ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse