HeyGen Avatar IV
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | heygen-avatar-iv |
|---|---|
| 能力 | 照片数字人视频 |
| 驱动方式 | 台词配音 / 音频驱动 |
| 输出 | MP4，720p / 1080p |
上传一张人像照片，用台词或驱动音频生成口型同步的说话视频。
生产建议
调用建议
- prompt 与 audio_url 必须二选一。
- 照片、音频和背景图都需传公开可访问的 HTTPS 链接。
- 照片建议使用正脸清晰、光线均匀、面部无遮挡的人像。
- 生产环境建议使用 callback.url 接收终态通知，并用 GET /v1/tasks/:id 做补偿查询。
适用场景
台词配音
传入照片和台词，选择声音后生成讲解视频。
image_urlpromptvoice音频驱动
传入照片和已有音频，直接驱动口型。
image_urlaudio_url竖版短视频
用 9:16 画幅输出，画幅与照片不同时用背景填充。
aspect_ratiobackground请求参数
model string 必填 模型 ID。
input object 必填 HeyGen Avatar IV 参数。
image_url string 必填 视频中说话的人物照片，需包含一张清晰的正脸。
prompt string 可选 让照片中人物说出的台词，最多 5000 个字符。与 audio_url 二选一。
voice string 可选 台词配音使用的声音。 查看全部预置声音 ↓
audio_url string 可选 驱动口型的音频，人物会按这段录音开口，最长 600 秒。与 prompt 二选一。
resolution enum 可选 输出视频分辨率。
aspect_ratio enum 可选 生成视频的宽高比，例如横屏 16:9 或竖屏 9:16；auto 沿用照片比例。
background object 可选 画幅与照片比例不同时，填充人像以外区域；不传时为白色。
type enum 必填 背景类型。
value string 必填 color 传 #RRGGBB 色值，image 传图片 HTTPS URL。
callback object 可选 任务进入终态时发送任务对象。
url string 必填 接收终态通知的 HTTPS 地址。
when enum 可选 任务终态时触发。
预置声音（102 个）
请求参数必须传卡片中的英文“请求值”，中文名称仅用于识别。
展开全部 102 个预置声音 收起全部 102 个预置声音
中文名称 温暖专业旁白 请求值
Warm Pro Narrator 中文名称 布莱恩 · 轻松 请求值
Chill Brian 中文名称 艾薇 请求值
Ivy 中文名称 约翰·多伊 请求值
John Doe 中文名称 莫妮卡·索甘 请求值
Monika Sogam 中文名称 霍普 · 音色 2 请求值
Hope 中文名称 Archer 请求值
Archer 中文名称 布兰妮 请求值
Brittney 中文名称 帕特里克 请求值
Patrick 中文名称 戴维·卡斯尔莫尔 请求值
David Castlemore 中文名称 迈克尔 C 请求值
Michael C 中文名称 Adam Stone 请求值
Adam Stone 中文名称 朱妮珀 请求值
Juniper 中文名称 Cassidy 请求值
Cassidy 中文名称 杰西卡·安妮·博加特 请求值
Jessica Anne Bogart 中文名称 阿拉贝拉 请求值
Arabella 中文名称 安德鲁 请求值
Andrew 中文名称 Spuds Oxley 请求值
Spuds Oxley 中文名称 格蕾丝·埃尔德 请求值
Grace Elder 中文名称 海伦 请求值
Helen 中文名称 峡谷之声 请求值
Canyon Rivers 中文名称 德雅 · 自然拟真 · 兴奋 请求值
Derya - Lifelike - Excited 中文名称 马库斯 · 温和 请求值
Mellow Marcus 中文名称 杰克·斯特林 · 播音腔 请求值
Jack Sterling - Broadcaster 中文名称 布伦达 · UGC 风格 请求值
Brenda - UGC - 1.mp4 中文名称 里德 请求值
Reid 中文名称 里根 请求值
Reagan 中文名称 特里 请求值
Terry 中文名称 珍妮 请求值
Jenny 中文名称 里克 · 电台播音 请求值
Radio Rick 中文名称 丹妮丝 请求值
Denise 中文名称 蒂姆 · 车内 · 兴奋 请求值
Tim in car - Excited 中文名称 伊斯坎德尔 请求值
Iskander 中文名称 汤普森 请求值
Thompson 中文名称 黛西 · 轻柔 · 兴奋 请求值
Delicate Daisy - Excited 中文名称 金斯顿 请求值
Kingston 中文名称 乔治 · UGC 风格 1 请求值
George UGC 1 中文名称 布莱克 · 有力 请求值
Bold Blake 中文名称 简 请求值
Jane 中文名称 埃文 · 富有表现力 请求值
Expressive Evan 中文名称 玛丽安 · IA 请求值
Marianne - IA 中文名称 亚伦 请求值
Aaron 中文名称 现代食谱主持 · 声音 1 请求值
Modern Recipe Host - Voice 1 中文名称 威洛 请求值
Willow 中文名称 克洛伊 · 亲切可爱 请求值
Cute Chloe - Friendly 中文名称 拉斐尔 请求值
Rafael 中文名称 琼 · 自然拟真 请求值
June - Lifelike 中文名称 克洛伊 · 清晰 请求值
Crisp Chloe 中文名称 西蒙 · 流畅 请求值
Slick Simon 中文名称 纳西姆 · 知性讲解 请求值
Nassim - Informative 中文名称 本 · 男中音 请求值
Baritone Ben 中文名称 麦克斯韦 请求值
Maxwell 中文名称 埃莉·费伊 · 兴奋 请求值
Ellie Faye - Excited 中文名称 米拉妮 请求值
Milani 中文名称 菲奥娜 · 活力兴奋 请求值
Feisty Fiona - Excited 中文名称 迪恩 · 教授风格 请求值
Professor Dean 中文名称 罗斯 · UGC 风格 请求值
Rose - UGC - 1.mp4 中文名称 肖娜 请求值
Shona 中文名称 哈德森·怀尔德 请求值
Hudson Wilder 中文名称 安 · IA 请求值
Ann - IA 中文名称 阿拉斯泰尔·肯辛顿 请求值
Alastair Kensington 中文名称 奥克斯利 请求值
Oxley 中文名称 克里斯蒂娜 请求值
Christina 中文名称 Andrew Rizz 请求值
Andrew Rizz 中文名称 佩顿 请求值
Peyton 中文名称 杰拉尔多 · 户外 请求值
Gerardo - Outdoor 中文名称 克洛伊 · 自然拟真 请求值
Chloe - Lifelike 中文名称 斯蒂芬妮 请求值
Stephanie 中文名称 安东尼 · IA 请求值
Anthony - IA 中文名称 Signal · 声音 1 请求值
Signal - Voice 1 中文名称 卢卡 请求值
Luca 中文名称 丽莎 · 声音 1 请求值
Lisa - Voice 1 中文名称 T.W. 塔克 请求值
T.W.Tucker 中文名称 杰克·沙利文 · 严肃 请求值
Jack Sullivan - Serious 中文名称 温特 请求值
Winter 中文名称 米蕾娅 · 自然拟真 请求值
Mireia - Lifelike 中文名称 乔治娅 请求值
Georgia 中文名称 斯特拉 请求值
Stella 中文名称 玛莎 · 自然拟真 请求值
Masha - Lifelike 中文名称 查尔斯 · 亲切迷人 请求值
Charming Charles - Friendly 中文名称 塞雷妮蒂 请求值
Serenity 中文名称 安妮 · 兴奋 请求值
Annie - Excited 中文名称 拉尔夫 请求值
Ralph 中文名称 贝瑟妮 请求值
Bethany 中文名称 多米尼克 请求值
Dominic 中文名称 梅森·芬 请求值
Mason Finn 中文名称 莉娜 请求值
Leena 中文名称 维克托 · 成熟 请求值
Veteran Victor 中文名称 塔玛拉 请求值
Tamara 中文名称 尼克 · 公共版 请求值
Nik Public 中文名称 克洛伊 · 沉稳 请求值
Calm Chloe 中文名称 塞维克 请求值
Sevik 中文名称 赖利 请求值
Reilly 中文名称 劳尔 请求值
Raul 中文名称 伊恩 · 威严 请求值
Imposing Ian 中文名称 雷 · 松弛 请求值
Relaxed Ray 中文名称 德克斯特 · 专业 请求值
Dexter - Professional 中文名称 里克 · 松弛 请求值
Relaxed Rick 中文名称 埃德温 请求值
Edwin 中文名称 鲁珀特·布莱克伍德 请求值
Rupert Blackwood 中文名称 金妮 请求值
Ginny 中文名称 霍普 · 音色 2 请求值
Hope 没有匹配的声音
用例示例
台词配音，1080p 横版
使用照片和台词生成横版讲解视频。
请求体
{
"model": "heygen-avatar-iv",
"input": {
"image_url": "https://example.com/portrait.png",
"prompt": "Hi, I'm Lin. With one photo and a short script, I can present your product or record a lesson, with natural lip-sync and expressions.",
"voice": "Cute Chloe - Friendly",
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}音频驱动，竖版带背景
使用已有音频驱动口型，输出 9:16 并用纯色填充留白。
请求体
{
"model": "heygen-avatar-iv",
"input": {
"image_url": "https://example.com/portrait.png",
"audio_url": "https://example.com/voice.mp3",
"resolution": "720p",
"aspect_ratio": "9:16",
"background": {
"type": "color",
"value": "#F5EFE6"
}
}
}获取结果
- 创建任务后从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态。
- status=success 时，从 output 中读取 type=video 的视频 URL。