HeyGen: HeyGen Video
HeyGen Video는 텍스트, 첫 이미지 또는 시각·오디오 참조에서 대사, 환경음과 효과음이 포함된 5–15초 장면을 생성합니다. 범용 heygen-video-1 모델은 참조 제어와 MP4 출력으로 제품·캐릭터 숏을 지원합니다. 명확하고 한정된 동작이 유용한 제작 기획이 됩니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
HeyGen Video는 제조사가 heygen-video-1로 식별하는 HeyGen의 범용 장면 생성 모델입니다. 창작 기획에서 피사체, 배경, 빛과 소리를 함께 만듭니다. 각 클립은 5–15초이며 대사, 환경음과 효과음을 포함한 생성 오디오 트랙을 담습니다. 유용한 제작 입력으로는 장면 설명, 제품 사진 또는 인물·장소·움직임을 정하는 자료가 있습니다. 결과 에셋은 제품 소개, 온보딩 삽입 영상, 부동산 소개나 다른 영상 편집에 사용할 짧은 장면입니다.
세 모드는 입력에 서로 다른 역할을 줍니다. 텍스트-비디오는 프롬프트에서 장면을 만듭니다. 이미지-비디오는 실제로 제공 이미지에서 시작한 뒤 동작 기획을 따릅니다. 참조-비디오는 제공한 이미지·영상과 선택적 오디오로 새로 구성한 장면을 안내하며 이미지나 영상 참조가 최소 하나 필요합니다. 시작 구도가 정지 이미지와 일치해야 한다면 첫 프레임 이미지를, 알려진 물체가 다른 구도에 나와야 한다면 참조를 선택하세요. 이 장면 모델은 HeyGen 아바타 렌더링 엔진 및 Video Agent 구성 워크플로와 구별됩니다.
제작사 가이드는 피사체 하나, 장소 하나와 한정된 동작 하나를 고정 또는 부드럽게 움직이는 카메라로 담는 상세하고 구체적인 숏 지시를 권장합니다. 카메라 위치, 렌즈나 피사계 심도 의도, 빛, 표면 질감과 색 처리를 설명하세요. 접촉이 필요한 동작에서는 물체가 어디에서 닿는지 설명합니다. 직접 만든 제품 예시에서는 여행용 보온병 참조 사진을 쓰고 나무 카운터 위 보온병 옆에서 진행자가 말하며 카메라가 보온병 쪽으로 조금 이동하도록 요청할 수 있습니다. 결과에서 보온병 형태, 위치와 보이는 표식을 확인하세요.
참조 목록은 이미지 최대 9개, 영상 3개와 오디오 3개를 지원하며 총 최대 12개입니다. 제조사 프롬프트 형식에서 이미지, 영상과 오디오는 각각 번호를 매기며 첫 이미지는 <Picture 1>, 첫 영상은 <Video 1>입니다. 각 참조에 역할을 주고 기획에서 명시적으로 식별하세요. 모델은 각 참조 영상의 첫 5초를 읽으므로 관련 구간을 시작 부분에 배치합니다. API 참조는 참조 영상 화면비를 1:4–4:1로 명시합니다. 원하는 움직임이 끝에만 나오는 긴 클립은 이 5초 입력 구간에 맞지 않는 준비입니다.
문서상 참조 인터페이스는 직접 접근 가능한 HTTPS 리소스, 업로드 에셋 식별자 또는 인라인 base64를 받습니다. 가이드의 최대 이미지 크기는 URL 제공 시 16MB, 인라인은 5MB이며 영상·오디오는 URL 제공 시 32MB, 인라인은 16MB입니다. 중요한 피사체가 쉽게 구별되고 여러 참조가 서로 충돌하는 지시를 주지 않도록 원본을 준비하세요. 첫 프레임 이미지에서 의도한 방향을 유지합니다. 이 입력 세부사항은 제작사 참조 워크플로에 관한 것으로 선택 모드의 창작 자료 정리에 도움이 됩니다.
화면과 같은 기획에서 소리도 연출하세요. 대사, 발성, 실내 기본 소음과 특정 효과를 명시하고 소리가 가까운지 먼지도 설명합니다. 장면에 말과 환경음만 있어야 한다면 원하는 음악 처리도 지정하세요. 가이드는 계획 추정치로 초당 약 2.5개의 발화 단어를 제안하므로 멈춤과 보이는 동작을 위한 여유를 남깁니다. 짧은 소개는 한 문장 뒤 제품을 드러내는 잠깐의 여유로 계획할 수 있습니다. 실제 단어와 생성 소리가 공간·동작에 맞는지 들어 보세요.
출력 길이는 5–15초 사이의 정수 초로 선택하며 기본값은 5초입니다. 해상도는 480p, 768p, 1080p 또는 2k 크기 등급입니다. 문서상 구도 선택은 21:9, 16:9, 4:3, 1:1, 3:4, 9:16입니다. 1080p 또는 2k 텍스트-비디오와 참조-비디오에서는 16:9 또는 9:16을 선택하며 적응형 참조 구도는 480p와 768p에서 문서화되어 있습니다. 이미지-비디오는 첫 이미지 비율을 따르므로 필요한 형태가 달라지면 생성 전에 자릅니다. 크기 등급 이름이 통상적인 특정 픽셀 쌍을 뜻한다고 가정하지 말고 완성 결과의 실제 크기를 검토하세요.
모델 가이드는 H.264 영상 인코딩과 32kHz 스테레오 AAC 오디오의 MP4 영상을 명시합니다. 생성은 비동기로 처리되며 완료 작업은 재생 가능한 영상 위치, 길이와 크기를 제공합니다. 서명된 영상 위치는 작업을 다시 조회해 갱신할 수 있습니다. 편집 검토를 위해 실제 클립, 참조 자료와 기획을 보관하세요. 대기·처리 기록은 생성을 추적하며 완성 영상이 화면·음성·소리를 평가할 제작 에셋입니다.
제조사는 프롬프트 향상 옵션으로 turbo, quality, disabled를 문서화하며 disabled는 준비 문구를 그대로 유지합니다. 고정 시드는 다른 입력을 유지하면서 한 절의 변경을 비교할 때 유용합니다. 선택 시드와 설정을 숏 기획에 기록하세요. 화면 글자는 의도한 문구를 짧고 정확하게 쓰며 가이드는 문단, 작은 글씨와 라벨 있는 도표를 나중에 합성하도록 권장합니다. 문구가 정확히 재현됐다고 가정하지 말고 생성 제목의 모든 글자를 확인하세요.
가이드는 긴 화면 텍스트, 꽃잎·종이·머리카락 같은 부드러운 유기적 움직임과 손으로 물체를 가까이 다루는 장면을 덜 안정적인 영역으로 식별합니다. 절차 설명에서는 명확하게 쓴 대사로 단계를 전달하고 화면에는 안정된 인물이나 물체를 보여 주세요. 물리적 조작 자체가 정확해야 할 때는 별도로 검증한 영상을 사용합니다. 숏 전체에서 물체 연속성, 접촉, 얼굴·손 디테일, 대사와 소리를 검토하세요. 다음 테이크에서 바꿀 내용을 간결하게 정리하면 상세한 제작 기획을 실용적으로 유지할 수 있습니다.
Ailoot Ultra · 동영상 POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1시작하기
HeyGen Video는 텍스트, 첫 이미지 또는 시각·오디오 참조에서 대사, 환경음과 효과음이 포함된 5–15초 장면을 생성합니다. 범용 heygen-video-1 모델은 참조 제어와 MP4 출력으로 제품·캐릭터 숏을 지원합니다. 명확하고 한정된 동작이 유용한 제작 기획이 됩니다.
- 허용 입력
- 텍스트 · 이미지 · 오디오 · 동영상
- 결과
- 동영상
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 동영상 POST /v1/videos
- 입력
text,image,audio,video- 출력
video- 출력 형식
- 원본 MP4 바이트(정규화·트랜스코딩 없음)
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 heygen/heygen-video-1 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드duration | 유형integer | 요건필수 | 값과 한도 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 최솟값: 1 최댓값: 600 | 기본값— |
필드resolution | 유형string | 요건선택 사항 | 값과 한도 480p, 768p, 2K | 기본값— |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 기본값— |
필드generate_audio | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값— |
필드frame_images | 유형array | 요건선택 사항 | 값과 한도 최소 항목 수: 1 최대 항목 수: 1 입력 콘텐츠: 프레임 객체 배열입니다. 각 객체에는 type=image_url, url을 포함하는 image_url 및 frame_type이 있습니다. HTTPS 이미지 URL을 사용하고 frame_type을 first_frame으로 설정하세요. 각 프레임 역할은 최대 한 번만 나타날 수 있습니다. 정확한 키: type, image_url, frame_type 조건: 이 키는 각 프레임 객체를 설명합니다. image_url에는 url만 포함됩니다. 텍스트만 사용하는 요청에서는 frame_images를 생략하세요. | 기본값— |
필드input_references | 유형array | 요건선택 사항 | 값과 한도 | 기본값— |
필드seed | 유형integer | 요건선택 사항 | 값과 한도 최솟값: -9,223,372,036,854,775,808 최댓값: 9,223,372,036,854,775,807 | 기본값— |
필드callback_url | 유형string | 요건선택 사항 | 값과 한도 패턴: ^https:// | 기본값— |
필드session_id | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드trace | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
필드user | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
입력 자료 조합
텍스트로 동영상 생성 · 작성한 프롬프트입니다. · 필수: model, prompt, duration
prompt는 텍스트로, duration은 정수 단위 초로 제공하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.
model: 유형: string · heygen/heygen-video-1
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
이미지로 동영상 생성 · 작성한 프롬프트와 첫 프레임 이미지입니다. · 필수: model, prompt, duration, frame_images
frame_images는 배열입니다. 각 프레임 객체에는 type, image_url, frame_type이 있으며, image_url에는 url이 포함됩니다. type을 image_url로 설정하세요. first_frame을 사용하세요. 각 프레임 역할은 최대 한 번만 나타날 수 있습니다. 각 프레임에 공개 HTTPS 이미지 URL을 제공하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.
정확한 키: type, image_url, frame_type
model: 유형: string · heygen/heygen-video-1
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
Reference to video · 작성한 프롬프트와 지원되는 이미지, 동영상, 오디오 참조 자료입니다. · 필수: model, prompt, duration, input_references
input_references는 객체 배열입니다. type을 image_url, video_url, audio_url로 설정하고 url을 포함하는 해당 필드를 사용하세요. 공개 HTTPS URL을 사용하세요. 참조 모드를 선택하려면 frame_images를 생략하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.
model: 유형: string · heygen/heygen-video-1
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt, duration |
매개변수material_types | 명세text, image, audio, video |
매개변수additional_properties | 명세false |
매개변수optional_controls | 명세resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
수명 주기: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 단위 | 과금 조건 | 요금 |
|---|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 단위— | 과금 조건— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건resolution: 2k | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.2 동영상 초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건resolution: 480p | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.04 동영상 초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건resolution: 768p | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.072 동영상 초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건생성 모드: reference; 해상도: 2k | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.36 동영상 초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건생성 모드: reference; 해상도: 480p | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.14 동영상 초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건생성 모드: reference; 해상도: 768p | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.2 동영상 초당 |
| 설정참조용 입력 이미지 | 요금표— | 예측 수량— | 과금 단위참조 입력 이미지당 | 과금 조건— | 요금 입력 · 참조용 입력 이미지 · 비교 전용 추정치 $0.08 참조 입력 이미지당 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 과금 조건— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.2 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
동영상 설정별 요금 참조
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정동영상 요금 | 과금 조건resolution: 2k | 요금 출력 · 동영상 가격 $0.18 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
| 설정동영상 요금 | 과금 조건resolution: 480p | 요금 출력 · 동영상 가격 $0.04 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
| 설정동영상 요금 | 과금 조건resolution: 768p | 요금 출력 · 동영상 가격 $0.06 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
| 설정동영상 요금 | 과금 조건생성 모드: reference; 해상도: 2k | 요금 출력 · 동영상 가격 $0.36 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
| 설정동영상 요금 | 과금 조건생성 모드: reference; 해상도: 480p | 요금 출력 · 동영상 가격 $0.08 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
| 설정동영상 요금 | 과금 조건생성 모드: reference; 해상도: 768p | 요금 출력 · 동영상 가격 $0.12 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다. |
요청 예제
Ailoot Ultra · 동영상
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 동영상
소유한 콘텐츠의 서명된 URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
작업 상태 확인
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
완료된 결과 모두 보관
완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.
실제로 소유한 모든 출력과 함께 반환된 측정 메타데이터를 보존하세요.
원래 응답을 확인해야 할 경우
503 result_pending_check + 원래 id + X-Should-Retry:false; 원래 요청을 절대로 재전송하지 마세요.
응답 필드
| 필드 | 유형 | 의미 |
|---|---|---|
필드index | 유형integer | 의미출력 목록에서 이 동영상의 영부터 시작하는 위치입니다. |
필드content_url | 유형string | 의미완료된 이 동영상의 서명된 HTTPS 다운로드 URL입니다. |
필드sha256 | 유형string | null | 의미원본 동영상 바이트의 SHA-256 다이제스트입니다. 확인할 수 없으면 null입니다. |
필드size_bytes | 유형integer | null | 의미바이트 단위 원본 동영상 파일 크기입니다. 확인할 수 없으면 null입니다. |
필드duration_ms | 유형integer | null | 의미밀리초 단위로 측정한 동영상 길이입니다. 확인할 수 없으면 null입니다. |
필드width | 유형integer | null | 의미픽셀 단위 동영상 너비입니다. 확인할 수 없으면 null입니다. |
필드height | 유형integer | null | 의미픽셀 단위 동영상 높이입니다. 확인할 수 없으면 null입니다. |
필드video_codec | 유형string | null | 의미동영상 코덱 식별자입니다. 기록되지 않았으면 null입니다. |
필드has_audio | 유형boolean | null | 의미동영상에 오디오 트랙이 포함되어 있는지 나타냅니다. 측정하지 않았으면 null입니다. |
필드audio_codec | 유형string | null | 의미오디오 코덱 식별자입니다. 식별자가 기록되지 않았으면 null입니다. |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답404 · not_found_error | 조건동영상에 접근할 수 없거나 해당 동영상 ID를 찾지 못했습니다. | 다음 단계동영상 접근 권한을 확인하세요. 기존 동영상에는 원래 공개 ID와 동일한 API 키를 사용하세요. |
응답401 · authentication_error | 조건API 키가 인증된 계정과 일치하지 않습니다. | 다음 단계제출 전에 API 키와 계정 접근 권한을 확인하세요. |
응답400 · invalid_request_error | 조건요청을 읽을 수 없거나 다운로드 인덱스가 유효하지 않습니다. | 다음 단계요청 본문을 수정하세요. 다운로드할 때는 원래 작업에서 반환된 출력 인덱스를 선택하세요. |
응답422 · price_unavailable | 조건선택한 동영상 설정의 요금을 계산할 수 없습니다. | 다음 단계지원되는 동영상 설정을 선택하고 필수 옵션을 모두 지정한 뒤 수정된 요청을 제출하세요. |
응답422 · invalid_request_error | 조건동영상 입력 또는 원래 이어 만들기 작업이 유효하지 않습니다. | 다음 단계유효한 HTTPS 입력을 사용하세요. 이어 만들기에는 동일한 API 키로 완료된 원본의 공개 동영상 ID를 사용하세요. |
응답402 · billing_error | 조건사용 가능한 잔액 또는 한도로는 예약할 수 없습니다. | 다음 단계새 요청을 전송하기 전에 사용 가능한 잔액과 한도를 확인하세요. |
응답503 · server_error | 조건동영상 검증, 저장소 또는 서비스 접근을 일시적으로 사용할 수 없습니다. | 다음 단계서비스를 사용할 수 있을 때까지 기다리세요. 이미 동영상 ID가 있으면 새로 생성하지 말고 해당 원래 작업을 확인하세요. |
응답503 · result_pending_check | 조건원래 동영상 결과와 청구액을 확인해야 합니다. | 다음 단계반환된 동영상 ID를 보존하고 해당 작업을 확인하세요. 확인 중에는 대체 생성 요청을 전송하지 마세요. |
응답503 · owned_result_unavailable | 조건기존 동영상 다운로드를 일시적으로 사용할 수 없습니다. | 다음 단계나중에 동일한 동영상 작업을 확인하고 기존 출력을 다운로드하세요. 새로 생성하면 별도의 작업이 만들어집니다. |
응답409 · video_not_ready | 조건동영상 콘텐츠가 게시되지 않았습니다. | 다음 단계원래 작업 상태를 확인하세요. completed를 보고하면 다운로드하고, failed를 보고하면 청구 확인 안내를 따르세요. |
별칭
모델 별칭
Ailoot Ultra heygen/heygen-video-1
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · HeyGen: HeyGen Video
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- 요청은 어떤 필드를 사용하나요?
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- 어떤 제한이 적용되나요?
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807