guides

HeyGen Avatar 6 API: HeyGen Avatar 6이란? 모델 ID, 입력 모드, 제한, 가격

Poyo.ai Team
7 min read
Share:

PoYo의 HeyGen Avatar 6 API: 모델 ID, 입력 모드, 제한, 가격

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-6heygen-avatar-6-turbo
HeyGen 티어Avatar 6 QualityAvatar 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_urlaspect_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_url2~60초, 최대 15 MB. 영상 길이는 오디오 길이와 같음
text1~1,000자(공개 아바타 모드에서 audio_url 대신 사용)
avatar1,248개 이름(156명) 중 하나. 대소문자와 여분의 공백은 무시됨
voice102개 이름 중 하나. 기본값 Warm Pro Narrator
prompt최대 1,200자
resolution1080p 또는 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-turbo10크레딧($0.05)18크레딧($0.09)100크레딧($0.50)600크레딧($3.00)
heygen-avatar-620크레딧($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-turboAbigail Office Front / Jessica Anne Bogart27단어, 16:9, 1080p10.16초110크레딧(11초 × 10)약 2.4분
heygen-avatar-6Bryan Tech Expert / Andrew21단어, 16:9, 1080p6.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합니다. 상태 엔드포인트를 폴링할 수도 있습니다.

Share: