跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
HeyGen Avatar 6 把说话者变成一段说话视频,口型同步,带有面部表情和自然手势。可以驱动一张人物照片、参考视频中的动画或插画角色,或 HeyGen 的公共形象。语音来自音频文件;使用公共形象时,也可以由 HeyGen 声音朗读一段文字。系统根据传入的参数自动选择模式。

模型

  • heygen-avatar-6 — 生成 1080p 或 2K 的说话数字人视频,支持照片、参考视频和公共形象三种模式
  • heygen-avatar-6-turbo — Avatar 6 的 Turbo 档,输入参数和模式与标准版相同

功能

  • 三种输入模式:人物照片、动画或插画角色的参考视频,或 HeyGen 公共形象。
  • 由音频决定时长:视频时长与语音音频一致,2 到 60 秒。
  • 公共形象文字朗读:传入 text 和可选的 voice,形象会朗读这段文字。
  • 动作引导:用 prompt 引导手势、表情和姿态。
  • 输出:1080p 或 2K。公共形象视频可选 16:9、9:16、1:1、4:5 或 5:4。

输入模式

每种模式接受该行列出的输入,以及通用选项 prompt 和 resolution。aspect_ratio 和 voice 属于公共形象模式。每个请求使用同一种模式的输入。

必填参数

  • image_urls(字符串数组):照片模式。恰好一张要驱动的人物照片,使用 image_urls[0]。
  • video_url(字符串):参考视频模式。一段动画或插画角色的视频,时长至少 2 秒,大小不超过 50 MB。
  • avatar(字符串):公共形象模式。形象与声音中列出的 1,248 个 HeyGen 公共形象之一,例如 Abigail Sofa Front。名称匹配不区分大小写,也不受多余空格影响。
  • audio_url(字符串):照片模式和参考视频模式的语音音频。公共形象模式下传 audio_url 或 text 二者之一。音频时长 2–60 秒,大小不超过 15 MB;视频时长与音频一致。
  • text(字符串):公共形象模式,替代 audio_url 使用。形象要朗读的文字,最多 1,000 个字符。

可选参数

  • image_urls(字符串数组):参考视频模式。一张同一角色的参考照片。
  • voice(字符串):公共形象模式下配合 text 使用。朗读文字的 HeyGen 声音,可选形象与声音中的 102 个声音之一。名称匹配不区分大小写,也不受多余空格影响。默认值:Warm Pro Narrator。
  • prompt(字符串):引导形象的手势、表情和姿态,最多 1,200 个字符。
  • aspect_ratio(字符串):公共形象模式。16:9、9:16、1:1、4:5 或 5:4。默认值:16:9。照片模式和参考视频模式下,视频沿用输入照片或视频的宽高比。
  • resolution(字符串):1080p 或 2K。默认值:1080p。

输出

  • 一个 MP4 视频文件。
  • 视频时长跟随语音:等于 audio_url 的时长,或形象朗读完 text 所用的时间。视频可能比音频短约十分之一秒。

示例

照片

参考视频

公共形象 + 音频

公共形象 + 文字

注意事项

  • 所有媒体 URL 都必须可通过 HTTP 或 HTTPS 公开访问并可直接下载。
  • 音频时长和参考视频时长在提交任务时检查。
  • avatar 在提交任务时按形象列表检查。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

HeyGen Avatar 6 模型标识

可用选项:
heygen-avatar-6,
heygen-avatar-6-turbo
input
object
必填

按传入的参数自动选择模式:传 avatar 为公共形象模式;否则传 video_url 为参考视频模式;否则为照片模式。每个请求使用同一种模式的参数。

callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填