모델
대시보드

HeyGen: Avatar IV

Markdown · JSON

HeyGen: Avatar IV

Avatar IV는 사진을 입 모양이 동기화된 말하는 영상으로 움직이며, 음성이 표정과 제스처 타이밍을 안내합니다. HeyGen은 실사형·스타일화된 진행자를 위한 대본 또는 녹음 오디오 워크플로와 Photo Avatar 움직임 제어를 문서화합니다.

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Avatar IV는 정지 이미지를 표현력 있는 말하는 영상으로 바꾸는 HeyGen의 아바타 엔진입니다. 확산 모델에서 영감을 받은 오디오-표정 설계는 목소리의 톤, 리듬과 감정으로 얼굴 움직임, 고개 기울이기, 멈춤과 미세 표정을 안내합니다. 목적은 영화적 프롬프트에서 배경과 사운드트랙 전체를 만드는 범용 장면 생성이 아니라, 진행자나 캐릭터가 립싱크와 제스처로 말하는 내용을 전달하는 것입니다.

제조사는 비스듬한 이미지나 옆모습, 애니메이션풍 얼굴과 반려동물을 포함한 실사형·스타일화된 캐릭터 지원을 설명합니다. 사진 기반 캐릭터는 눈, 입과 얼굴 구조가 쉽게 식별될 때 가장 잘 작동합니다. HeyGen은 자연스러운 자세와 좋은 조명의 선명한 이미지를 권장하며 제스처가 중요하면 손도 보이게 합니다. 아주 작은 얼굴, 가려진 입술, 두꺼운 가면, 두드러진 부리나 매우 과장된 비율은 얼굴 움직임과 립싱크를 약화할 수 있습니다. 원본 구도를 의도한 연기에 맞춰 유지하세요.

제작사는 두 음성 입력 경로를 제공합니다. 글로 쓴 대본은 선택 음성과 짝을 이루고, 미리 녹음한 오디오 트랙은 목소리와 타이밍을 직접 제공합니다. 발화가 이미 정해졌으면 녹음 오디오 경로를, 음성을 합성해야 하면 대본 경로를 사용하세요. 문서상 인터페이스에서 이 입력들은 대안입니다. 움직이게 하기 전에 최종 문구, 이름과 발음을 준비하고 말한 결과를 확인하도록 오디오나 대본을 반환 영상과 함께 보관합니다.

HeyGen Avatar IV 모델 프로파일은 스튜디오 아바타, Digital Twins, Photo Avatars, 직접 이미지와 프롬프트 생성 피사체를 다룹니다. 재사용 가능한 Photo Avatar는 이후 영상에 안정된 피사체를 제공하고 직접 이미지 워크플로는 제공 사진에서 시작합니다. 제작사의 Photo Avatar 프로파일은 자유 텍스트 움직임 지시와 high, medium, low 표현력 선택을 제공하며 기본값은 low입니다. 시리즈 제작에서는 선택한 아바타 외형과 엔진을 유지해, 원본 이미지나 렌더링 모델의 변경으로 진행자의 모습이 눈치채지 못한 사이에 달라지는 일이 없도록 하세요.

움직임 연출에서는 눈에 보이는 신체 동작과 감정적 성격을 설명하세요. “따뜻한 미소로 부드럽게 고개를 끄덕인다”는 제스처 하나와 표정 하나를 주며, 짧은 인사에는 친근하게 손 흔들기를 쓸 수 있습니다. 제작사는 주요 제스처 하나에 선택적으로 표정을 결합하고 순차 동작은 짧은 절 2개 이내로 권장합니다. Avatar IV는 연기에서 속도를 처리하므로 Studio 가이드는 초 단위 제스처 일정을 요구하지 않습니다. 구체적이고 간결한 문구가 하나의 프롬프트에 여러 경쟁 동작을 넣는 것보다 확인하기 쉽습니다.

제작사의 오디오-비디오 프로파일은 요청당 최대 30분의 제공 오디오를 렌더링하며 업로드 MP3·WAV 에셋은 32MB 제한입니다. 긴 수업이나 녹음은 자연스러운 발화 경계로 나누고 원래 순서를 유지하세요. 최종 영상의 말하기 타이밍은 무관한 클립 길이 추정치가 아니라 선택 오디오를 따라야 합니다.

제작사의 문서상 출력 설정은 720p 또는 1080p, 16:9, 9:16, 4:5, 5:4, 1:1 형태 및 원본 비율을 따르는 자동 옵션을 포함합니다. cover 맞춤은 피사체를 자를 수 있고 contain은 전체 피사체를 맞추며 주변 배경이 보일 수 있습니다. 오디오-비디오 워크플로는 기본적으로 MP4를 반환합니다. 영상 아바타의 투명 WebM 출력에는 매팅 지원이 필요하며 제작사는 새 배경과 결합하는 대신 해당 출력에 배경 제거를 적용합니다. 큰 구성에 진행자를 배치하기 전에 실제 구도와 파일을 확인하세요.

교육 도입부에서는 알아보기 쉬운 진행자 이미지, 간결한 설명과 핵심 지시의 절제된 제스처 하나를 사용할 수 있습니다. 제품 설명에서는 아바타 외형을 유지하며 기능마다 대본을 바꿀 수 있습니다. 제작사는 선택적인 자막 파일과 영상에 입힌 자막도 문서화하며 음성과 함께 문구·타이밍을 검토해야 합니다. 제작사 인터페이스의 렌더링은 비동기이므로 생성 응답과 완성 영상은 다른 에셋입니다. 작업 결과에 완성 녹화와 완료 상태를 함께 보관하세요.

Avatar IV는 Avatar V의 참조 기반 움직임과 별도 Studio 프리셋 제어와 구별됩니다. HeyGen Video의 범용 장면 생성이나 실시간 대화형 아바타와도 다릅니다. 렌더링된 입 움직임, 보이는 손, 표정, 멈춤과 발화 문구를 원본 자료 및 의도한 톤과 비교하세요. 이미지, 자세, 조명과 움직임 지시는 결과에 영향을 줍니다. 사진 기반 애니메이션은 생성된 연기로 검토하고 이후 수정을 위해 선택 입력을 보관해야 합니다.

Ailoot Ultra · 동영상 POST /v1/videos heygen/avatar-iv

heygen/avatar-iv

HeyGen /heygen/avatar-iv

시작하기

Avatar IV는 사진을 입 모양이 동기화된 말하는 영상으로 움직이며, 음성이 표정과 제스처 타이밍을 안내합니다. HeyGen은 실사형·스타일화된 진행자를 위한 대본 또는 녹음 오디오 워크플로와 Photo Avatar 움직임 제어를 문서화합니다.

허용 입력
텍스트 · 이미지 · 오디오 · 동영상
결과
동영상

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 동영상 POST /v1/videos
입력
text, image, audio, video
출력
video
필드유형요건값과 한도기본값
필드model유형string요건필수값과 한도
heygen/avatar-iv
기본값—
필드input_references유형array요건필수값과 한도
최소 항목 수: 2
최대 항목 수: 2
기본값—
필드prompt유형string요건선택 사항값과 한도기본값—
메서드 매개변수와 수명 주기
매개변수명세
매개변수content_type명세application/json
매개변수required명세model, input_references
매개변수material_types명세text, image, audio, video
매개변수material_conditions명세실제로 완료된 소유 미디어 자산의 콘텐츠 URL과 함께 반환된 서명을 사용하세요. BFL에는 동영상 소스 하나, 아바타에는 이미지 소스 하나와 오디오 소스 하나가 필요합니다. 원본 자산의 소유자/유형/바이트 증빙이 필요합니다., PNG/JPEG 이미지 자산 하나와 WAV/MP3 오디오 자산 하나를 정확히 제공하세요. 오디오는 최대 32000000바이트이며, 길이는 0초보다 크고 최대 1800초입니다.

수명 주기: asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · 실제로 반환된 id 또는 polling_url

GET /v1/videos/{request_id}/content

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드
미지정 빠른 모드를 선택한 경우
Flex 모드
미지정 flex 모드를 선택한 경우
최대 추론 수준
미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정요금표예측 수량과금 단위과금 조건요금
설정기본 토큰 요금요금표기본 요금예측 수량—과금 단위—과금 조건—요금
입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰
출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정동영상 요금요금표—예측 수량—과금 단위동영상 초당과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다.요금
출력 · 동영상 가격 · 비교 전용 추정치 $0.1 동영상 초당
설정예상 생성 비용요금표—예측 수량1회 생성 예상치과금 단위—과금 조건—요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $0.1 생성 전 추정치

이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 동영상

실제 입력을 사용하고 결과 전체를 보관하세요
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

결과 수신 및 저장

Ailoot Ultra · 동영상

  • GET /v1/videos/{request_id}
  • GET /v1/videos/{request_id}/content
완료된 자산 모두 저장
GET · 완료된 모든 자산 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt
완료된 결과 모두 보관

완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.

전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.

원래 응답을 확인해야 할 경우

X-Client-Request-ID, X-Ailoot-Task-Id 및 실제로 반환된 id/polling_url을 보존하세요. 원래 작업을 계속 진행하고 생성을 다시 제출하지 마세요.

응답 필드
필드유형
필드id유형
필드status유형
필드data[]유형
필드outputs[]유형

별칭

모델 별칭

Ailoot Ultra heygen/avatar-iv

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

관련 호출용 ID

heygen/avatar-iv

FAQ · HeyGen: Avatar IV
어떤 입력과 결과를 사용할 수 있나요?

POST /v1/videos · heygen/avatar-iv: text, image, audio, video → video

요청은 어떤 필드를 사용하나요?

POST /v1/videos · heygen/avatar-iv: model, input_references, prompt

자세히 보기

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독
정기 요청에 맞는 할인 요금제를 선택하세요.
최대 50% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약

로그인회원가입대시보드
요금
시작하기
연결
API
대시보드 API
연동
비용과 잔액
도움말