如何获取 HeyGen AI视频开放平台 密钥(分步指南)

在人工智能视频生成与创作领域，HeyGen AI 视频开放平台为开发者提供了全面的 API 工具，能够轻松集成高质量的 AI 视频生成能力。通过使用该平台的 API，开发者可以实现视频内容的自动化生成、个性化定制及多场景应用，快速提升内容生产效率和创新能力。本文将指导你如何获取 HeyGen AI 视频开放平台 API 密钥，并进行初步测试，同时强调在实际使用中需要关注的关键功能和权限管理。

1. 获取HeyGen AI视频开放平台API密钥步骤

获取HeyGen AI视频开放平台API密钥的过程相对简单，只需几个步骤即可完成：

1.访问 幂简平台中 HeyGen AI视频开放平台 服务商：

点击右侧访问官网

2.在官网中点击登录、注册。

3.登录成功以后会自动进入，鼠标悬停左下角会出现设置，点击设置。

4.进入设置页面以后，点击左侧的 订阅与API，点击顶部Tba栏中的 Heygen API

5.在 Heygen API 页面就可以看到自己的密钥和其他相关信息。

2. HeyGen AI视频开放平台 API密钥可用性测试

在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是使用curl进行测试的一个案例

以下接口为HeyGen AI视频开放平台 接口中 照片头像->检查照片/外观生成状态 接口。

输入：

curl --location --request GET 'https://api.heygen.com/v2/photo_avatar/generation/2d050c331acc494c800d740ba52a0ae7' \
--header 'x-api-key: 你的密钥' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Host: api.heygen.com' \
--header 'Connection: keep-alive'

输出：

结果以 JSON 格式返回，内容包含 HeyGen AI 照片生成接口的完整响应信息，包括任务 ID、生成状态、图片 URL 列表及对应的图片键值列表，全面展示了当前请求范围内的照片生成结果与资源路径，便于开发者快速获取和管理生成的照片资源。

{
  "error": null,
  "data": {
      "id": "2d050c331acc494c800d740ba52a0ae7",
      "status": "success",
      "msg": null,
      "image_url_list": [
          "https://resource2.heygen.ai/photo_generation/2d050c331acc494c800d740ba52a0ae7/b167e210-29b9-4e80-ba69-5db5cf74b87f.jpg",
          "https://resource2.heygen.ai/photo_generation/2d050c331acc494c800d740ba52a0ae7/c9ab5ad2-8ac8-416c-8ef1-646bccf3fa3a.jpg",
          "https://resource2.heygen.ai/photo_generation/2d050c331acc494c800d740ba52a0ae7/fe9c3ac8-ec58-49ed-b09e-005a4d06fb3f.jpg",
          "https://resource2.heygen.ai/photo_generation/2d050c331acc494c800d740ba52a0ae7/f3056aa2-65f4-4944-92ae-593f59435487.jpg"
      ],
      "image_key_list": [
          "photo_generation/2d050c331acc494c800d740ba52a0ae7/b167e210-29b9-4e80-ba69-5db5cf74b87f.jpg",
          "photo_generation/2d050c331acc494c800d740ba52a0ae7/c9ab5ad2-8ac8-416c-8ef1-646bccf3fa3a.jpg",
          "photo_generation/2d050c331acc494c800d740ba52a0ae7/fe9c3ac8-ec58-49ed-b09e-005a4d06fb3f.jpg",
          "photo_generation/2d050c331acc494c800d740ba52a0ae7/f3056aa2-65f4-4944-92ae-593f59435487.jpg"
      ]
  }
}

3. 使用HeyGen AI视频开放平台API搭建应用的其他关键考虑因素

在使用HeyGen AI视频开放平台API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：

API 密钥

要访问 HeyGen 的 API 并执行操作，您必须使用 HTTP X-Api-Key 头部对请求进行身份验证和授权。

如何使用 API 密钥

请在请求头中添加： X-Api-Key：你的API密钥 。

速率限制

所有用户——包括免费计划用户——每月均可获得 10 个 API 调用额度用于测试 API。

API 积分消耗规则

API 积分用于执行各种任务，如创建视频、翻译内容或使用交互式头像 。积分的使用取决于端点：

常见状态码

4. HeyGen AI视频开放平台API密钥申请和使用中的常见问题

在申请和使用 HeyGen AI视频开放平台API密钥过程中，你可能会遇到以下常见问题：

如何认证 / 授权调用 HeyGen API？

请求需要在 HTTP 头里使用 X-Api-Key 来传你的 API Token。你可以在 HeyGen App 的 Space 设置里的 API 标签页找到这个 Token。

如果 API 返回 “INVALID_CREDENTIALS” 或 “ACCESS_TOKEN_EXPIRED” 这种错误，我该怎么办？

• “INVALID_CREDENTIALS” 表示提供的 API Key 或 OAuth token 无效。
• ACCESS_TOKEN_EXPIRED” 表示你的 token 已过期，需要重新获取或刷新。 You 应该检查 Token 是否正确、是否还有效。必要时在 HeyGen 控制台重新生成或联系支持。

在使用 video/generate 或 photo_avatar 这类接口时，有哪些资源（图片、视频、音频）格式和大小的限制？

对资源有以下要求：

• 支持的格式：例如视频 MP4，图像 JPG/PNG，音频 WAV／MP3 等。
• 最大文件大小限制：视频 <100MB，图像 <50MB，音频 <50MB（视具体 endpoint）
• 视频分辨率（宽、高）必须介于某些最小值和最大值之间，并且要是偶数。超出这些范围或格式不支持会报错。

5. HeyGen AI视频开放平台API进阶指引

在获得HeyGen AI视频开放平台API密钥之后，即可开启API接口对接，本文整理了多篇使用HeyGen AI视频开放平台API的案例，帮助读者更有效地使用HeyGen AI视频开放平台API：

列出所有头像、创建头像视频、获取视频列表、创建 WebM 视频、创建头像 IV 视频

6. 常见问题

问题1： 什么是幂简集成平台？

幂简集成是蜜堂有信在2023年打造的一款SAAS产品，建设着国内最全的API平台，为开发者提供全面、高效、易用的API集成管理方案，一站搜索、试用、集成国内和国外API。让用户在AI时代全方位接入互联网，用API连接一切服务和算力，实现价值倍增。

问题2：如何找到HeyGen AI视频开放平台API

幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’HeyGen AI视频开放平台API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。

问题3：HeyGen AI视频开放平台API的替代品有哪些？

市场上存在免费、付费两种替代者

例如

vidon-Vidon.ai

Synthesia-AI视频生成器 – 几分钟内创建AI视频 – 免费试用

Vidyard-用于虚拟销售和营销团队的视频工具

lightricks-极速AI视频生成器

Media.io-在线视频、音频、图像人工智能工具

更多竞品可以在HeyGen AI视频开放平台找到。

7. 总结

本文总结了 HeyGen AI 视频开放平台 API 的使用流程，从获取与测试 API 密钥入手，结合实际接口调用示例，展示了如何验证其可用性，并进一步探讨了搭建应用时的关键因素，包括鉴权方式、调用额度、积分消耗规则及常见状态码。同时，文章整理了常见问题与解决方案，并提供了进阶使用指引和替代方案，帮助开发者在实际应用中更高效地接入与管理 HeyGen API，从而提升开发效率与应用稳定性。