curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "heygen/avatar-6/ref-video-to-video",
"input": {
"video_url": "https://cdn.vidgo.ai/temp/cartoon-character.mp4",
"image_urls": [
"https://cdn.vidgo.ai/temp/cartoon-character.png"
],
"audio_url": "https://cdn.vidgo.ai/temp/speech.mp3",
"resolution": "2K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "not_started",
"created_time": "2026-11-19T10:30:00"
}
}{
"detail": "video_url is required"
}{
"detail": "video_url is required"
}HeyGen
HeyGen Avatar 6 参考视频生视频
HeyGen Avatar 6 参考视频生视频 API 让参考视频中的动画或插画角色说出 2–60 秒的语音,分辨率 1080p 或 2K。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "heygen/avatar-6/ref-video-to-video",
"input": {
"video_url": "https://cdn.vidgo.ai/temp/cartoon-character.mp4",
"image_urls": [
"https://cdn.vidgo.ai/temp/cartoon-character.png"
],
"audio_url": "https://cdn.vidgo.ai/temp/speech.mp3",
"resolution": "2K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "not_started",
"created_time": "2026-11-19T10:30:00"
}
}{
"detail": "video_url is required"
}{
"detail": "video_url is required"
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url,都可以通过统一的查询任务状态接口获取结果。
模型
- heygen/avatar-6/ref-video-to-video — 动画角色参考视频 + 语音音频生成说话视频,1080p 或 2K。
功能
- 以参考视频驱动卡通和插画角色。
- 可选同一角色的参考图。
- 视频时长跟随音频,2–60 秒。
1080p或2K输出,保持参考视频的宽高比。
必填参数
video_url(string):动画或插画角色的视频,至少 2 秒,最大 50 MB,使用公开可访问的 HTTP(S) URL。audio_url(string):语音音频,时长 2–60 秒,最大 15 MB,使用公开可访问的 HTTP(S) URL。视频时长跟随音频。
可选参数
image_urls(string[]):同一角色的一张参考图。prompt(string):对手势、表情和姿态的引导,最多 1,200 个字符。resolution(string):1080p或2K。默认1080p。
输出
- 一个口型同步的 MP4 视频。
- 视频时长跟随语音,可能比音频短约十分之一秒。
示例
- 参考视频 + 参考图:卡通角色视频加同一角色的静态图,
2K。 - 仅参考视频:带一句动作引导。
注意事项
- 参考视频需至少 2 秒、最大 50 MB 且可下载,其他视频返回 400。此模式面向动画和插画角色;任务失败会全额退还积分。
- 提交时会检测音频:需为 2–60 秒、最大 15 MB 且可下载,其他音频返回 400。
model和callback_url放在请求根级,与input并列。input接收上文列出的本模式字段,其他字段返回 400。- 按秒计费,单价取决于
resolution。提交时按音频时长(向上取整到整秒)扣费。任务失败会全额退还。当前费率见定价页。
请求体
application/json