![]()
HeyGen Avatar 6 API가 PoYo에 출시되었습니다. 모델 ID는 두 가지로, heygen-avatar-6과 1080p 가격이 절반인 Turbo 티어 heygen-avatar-6-turbo입니다. 두 모델 모두 사진, 애니메이션 캐릭터의 참조 영상, 또는 HeyGen의 공개 아바타 룩 1,248개 중 하나를 1080p 또는 2K의 립싱크 토킹 MP4로 만들어 줍니다. 구동은 오디오로 하며, 공개 아바타의 경우 텍스트로도 가능합니다. 코드를 작성하기 전에 HeyGen Avatar 6 모델 페이지에서 두 티어를 모두 사용해 볼 수 있습니다.
이 개요에서는 HeyGen이 출시한 내용, PoYo의 요청 형식, 코드에서 검증해야 할 제한, 초당 가격, 그리고 출시 당일 측정한 결과를 다룹니다.
HeyGen Avatar 6이란?
HeyGen Avatar 6은 HeyGen의 토킹 아바타 영상 모델입니다. 2026년 11월 17일자 HeyGen의 기술 보고서는 "Avatar 6은 사람의 외모, 말투, 움직임을 최대 2K로 재현한다"고 밝히며, "사진 한 장으로" 작동한다고 설명합니다. HeyGen은 Avatar 6 Quality와 Avatar 6 Turbo 두 티어를 제시하며, PoYo에서는 각각 heygen-avatar-6과 heygen-avatar-6-turbo입니다.
| 날짜 | 내용 |
|---|---|
| 2026년 11월 17일 | HeyGen이 Avatar 6 기술 보고서 공개 |
| 2026년 11월 19일 | 두 티어 모두 PoYo에서 heygen-avatar-6과 heygen-avatar-6-turbo로 호출 가능 |
HeyGen의 주장 중 세 가지는 요청 필드와 직결되므로 연동에 중요합니다.
- 네이티브 2K. HeyGen은 "모든 프레임이 2880×1620으로 생성된다"고 말합니다. PoYo에서는
"resolution": "2K"로 선택합니다. - 모션 프롬프트. HeyGen 보고서에는 "동작을 대사 옆에 적으세요. Avatar 6이 정확한 타이밍에 연기합니다."라고 적혀 있습니다. PoYo에서는
prompt필드이며 최대 1,200자입니다. - Avatar V보다 선호됨. HeyGen의 온라인 투표에서 879표 중 69.7%가 Avatar V보다 Avatar 6 Quality를, 863표 중 64.3%가 Avatar V Turbo보다 Avatar 6 Turbo를 선호했습니다. 이는 HeyGen 자체 수치입니다.
HeyGen Avatar 6 API 한눈에 보기
| 항목 | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| HeyGen 티어 | Avatar 6 Quality | Avatar 6 Turbo |
| 제출 엔드포인트 | POST https://api.poyo.ai/api/generate/submit | 동일 |
| 결과 | GET /api/generate/status/{task_id} 또는 callback_url | 동일 |
| 입력 모드 | 사진, 참조 영상, 공개 아바타 | 동일한 세 가지 |
| 출력 | MP4 1개, 1080p(기본값) 또는 2K | 동일 |
| 음성 입력 | 오디오 2~60초, 또는 텍스트 최대 1,000자(공개 아바타 전용) | 동일 |
| 가격, 1080p | 초당 20크레딧($0.10) | 초당 10크레딧($0.05) |
| 가격, 2K | 초당 29크레딧($0.145) | 초당 18크레딧($0.09) |
요청 필드가 동일하므로 티어를 바꿀 때는 model 문자열만 바꾸면 됩니다. 필드 규칙은 PoYo HeyGen Avatar 6 문서에 있습니다.
세 가지 입력 모드, 하나의 엔드포인트
mode 필드는 없습니다. 보내는 입력에 따라 다음 순서로 모드가 결정됩니다.
| 모드 | 선택 조건 | 입력 | 화면 비율 |
|---|---|---|---|
| 공개 아바타 | avatar가 있음 | avatar + text(+ 선택 사항 voice), 또는 avatar + audio_url | aspect_ratio: 16:9(기본값), 9:16, 1:1, 4:5, 5:4 |
| 참조 영상 | video_url이 있음(avatar는 없음) | video_url + audio_url, 선택적으로 image_urls에 사진 1장 | 입력 영상을 따름 |
| 사진 | 기본값 | image_urls(정확히 1개) + audio_url | 입력 사진을 따름 |
prompt와 resolution은 모든 모드에서 작동합니다. aspect_ratio와 voice는 공개 아바타 모드 전용입니다. 요청 하나에는 한 모드의 입력만 보내세요. HeyGen 자체 개발자 문서는 이 작업을 두 개의 별도 API(이미지 또는 영상과 오디오를 다루는 모델 API, HeyGen 아바타 룩을 다루는 애플리케이션 API)로 나누지만, PoYo에서는 둘 다 하나의 요청 형식으로 처리합니다.
참조 영상 모드는 애니메이션이나 일러스트 캐릭터용입니다. 실제 인물에는 사진 한 장을 사용하는 사진 모드를 쓰세요.
제출 전에 검증할 제한
| 필드 | 규칙 |
|---|---|
image_urls | 정확히 1개의 URL. image_urls[0]이 사용됨 |
video_url | 최소 2초, 최대 50 MB |
audio_url | 2~60초, 최대 15 MB. 영상 길이는 오디오 길이와 같음 |
text | 1~1,000자(공개 아바타 모드에서 audio_url 대신 사용) |
avatar | 1,248개 이름(156명) 중 하나. 대소문자와 여분의 공백은 무시됨 |
voice | 102개 이름 중 하나. 기본값 Warm Pro Narrator |
prompt | 최대 1,200자 |
resolution | 1080p 또는 2K |
모든 미디어 URL은 공개되어 있고 HTTP 또는 HTTPS로 직접 다운로드할 수 있어야 합니다. PoYo는 제출 시점에 오디오 길이, 참조 영상 길이, 아바타 이름을 검사하므로 잘못된 입력은 기다리지 않고 바로 실패합니다. 출력은 오디오보다 약 0.1초 짧을 수 있습니다. 모든 아바타와 보이스 이름은 Avatars and Voices에 있으며, 다운로드 가능한 JSON 카탈로그도 제공됩니다.
PoYo의 HeyGen Avatar 6 API 가격
PoYo는 출력 1초당 크레딧으로 과금합니다(1크레딧 = $0.005).
| 모델 | 1080p 초당 | 2K 초당 | 1080p 10초 | 1080p 60초 |
|---|---|---|---|---|
heygen-avatar-6-turbo | 10크레딧($0.05) | 18크레딧($0.09) | 100크레딧($0.50) | 600크레딧($3.00) |
heygen-avatar-6 | 20크레딧($0.10) | 29크레딧($0.145) | 200크레딧($1.00) | 1,200크레딧($6.00) |
과금 초는 정수 초로 올림합니다. audio_url을 사용하면 요금은 오디오 길이를 따르며 제출 시 차감됩니다. text를 사용하면 PoYo가 제출 시 크레딧을 예약하고, 작업이 끝나면 완성된 영상 길이로 정산합니다. 계산 예시가 포함된 전체 내역은 HeyGen Avatar 6 API 가격에 있습니다.
출시 당일 테스트 결과
PoYo 팀은 2026년 11월 19일 프로덕션 API에서 텍스트를 사용하는 공개 아바타 모드로 다음 테스트를 실행했습니다. 소요 시간은 폴링 클라이언트가 본 제출부터 결과까지의 시간이므로 대략적인 수치로 보세요.
| 모델 | 아바타 / 보이스 | 스크립트 | 출력 | 현재 요금 기준 비용 | 소요 시간 |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27단어, 16:9, 1080p | 10.16초 | 110크레딧(11초 × 10) | 약 2.4분 |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21단어, 16:9, 1080p | 6.88초 | 140크레딧(7초 × 20) | 약 2분 |
짧은 클립에도 2분 이상 걸린다는 것은 이 API가 비동기 API라는 뜻입니다. 제출하고 task_id를 보관한 뒤 폴링하거나 콜백을 받으세요. 작업이 실행되는 동안 사용자 대상 HTTP 요청을 열어 둔 채 기다리지 마세요.
HeyGen Avatar 6 API 빠른 시작
다음은 텍스트를 사용하는 공개 아바타 모드의 문서 예시입니다.
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-avatar-6-turbo",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"prompt": "Speak with calm confidence and nod slightly at the end.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}'
응답 본문의 code를 확인하고(200이어야 함), data.task_id를 저장한 다음, status가 finished가 될 때까지 GET https://api.poyo.ai/api/generate/status/{task_id}를 호출하고 data.files[].file_url에서 MP4를 가져옵니다. 생성된 영상은 3일간 유지되므로 자체 스토리지로 복사하세요. 사진 모드, 참조 영상 모드, 상한이 있는 Python 루프, 오류 처리는 HeyGen Avatar 6 API 가이드에 있습니다.
HeyGen Avatar 6 API에 적합한 요청
| 필요한 것 | 호출 |
|---|---|
| 오디오 파일 없이 스크립트로 만드는 프레젠터 영상 | 공개 아바타 모드의 heygen-avatar-6 또는 -turbo(텍스트 투 아바타 안내) |
| 실제 인물 사진이 내 오디오를 말하는 영상, 1080p 또는 2K | 사진 모드 |
| 마스코트나 만화 캐릭터가 말하는 영상 | 참조 영상 모드 |
| 초안, 미리보기, 대량 생성 | heygen-avatar-6-turbo(Avatar 6 vs Turbo 참고) |
| 사진과 오디오로 가장 낮은 초당 가격 | Kling Avatar 2.0과 비교 |
| 60초보다 긴 오디오 | OmniHuman 2.0은 4~300초 오디오를 720p로 받으며 초당 21크레딧 |
자주 묻는 질문
HeyGen Avatar 6 API의 모델 ID는 무엇인가요?
heygen-avatar-6(HeyGen의 Avatar 6 Quality 티어)과 heygen-avatar-6-turbo입니다. 둘 다 동일한 input 필드로 POST https://api.poyo.ai/api/generate/submit를 사용합니다.
HeyGen Avatar 6 API 비용은 얼마인가요?
PoYo에서는 출력 초당 Turbo가 1080p에서 10크레딧($0.05), 2K에서 18크레딧($0.09)이고, Avatar 6이 1080p에서 20크레딧($0.10), 2K에서 29크레딧($0.145)입니다. 초는 올림 처리됩니다.
HeyGen Avatar 6 API로 텍스트만으로 영상을 만들 수 있나요?
네, 공개 아바타 모드에서 가능합니다. avatar와 최대 1,000자의 text, 그리고 선택적으로 102개 보이스 중 하나를 voice로 보내세요. 사진 모드와 참조 영상 모드에는 audio_url이 필요합니다.
HeyGen Avatar 6 API 영상은 얼마나 길게 만들 수 있나요?
오디오를 사용하면 2~60초이며 오디오 길이와 같습니다. 텍스트를 사용하면 아바타가 최대 1,000자를 읽는 데 걸리는 만큼의 길이가 됩니다.
HeyGen Avatar 6 API는 어떤 해상도를 지원하나요?
1080p(기본값)와 2K입니다. 공개 아바타 모드에서는 aspect_ratio(16:9, 9:16, 1:1, 4:5, 5:4)를 추가로 지정할 수 있고, 다른 모드는 입력의 화면 비율을 유지합니다.
HeyGen Avatar 6 API는 웹훅을 지원하나요?
네. 최상위에 callback_url을 추가하면 작업이 finished 또는 failed가 될 때 PoYo가 작업 결과를 POST합니다. 상태 엔드포인트를 폴링할 수도 있습니다.