공개 버전 및 엔드포인트
| 모델 ID | 엔드포인트 | 시작 가격 | 모델 카탈로그 |
|---|---|---|---|
heygen-video-1
|
/api/v1/heygen_video/text_to_video
/api/v1/heygen_video/image_to_video
|
$0.09 / 초 | 모델 상세 |
검증
Task가 최종 상태에 도달할 때까지 폴링합니다
POST /api/v1/heygen_video/text_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/heygen_video/text_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.설정
가이드 엔드포인트: /api/v1/heygen_video/text_to_video
export RUNAPI_API_KEY=your_api_key
curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.",
"output_resolution": "768p",
"aspect_ratio": "16:9"
}'3단계로 시작하기
-
모델 ID 선택
공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.
-
RunAPI 설정
엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.
-
결과 검증
비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.
OpenClaw + HeyGen Video로 만들 수 있는 것
-
제품 및 마케팅 클립
작성한 브리프를 바탕으로 제품 페이지, 광고, 랜딩 페이지용 짧은 홍보 영상을 만듭니다.
-
소셜 미디어 숏폼
소셜 피드용 짧은 클립을 만들고, 같은 아이디어로 여러 버전을 시도한 뒤 고릅니다.
-
이미지 애니메이션과 영상 편집
모델이 이미지-영상 변환이나 영상 편집 엔드포인트를 제공하는 경우 정지 이미지를 움직이게 하거나 기존 영상을 수정합니다.
HeyGen Video을(를) RunAPI + OpenClaw로 사용하는 이유
-
1개 변형 모델, 하나의 API 키
하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.
-
명확한 사용 요금
요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.
-
자동화된 작업 워크플로
수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.
OpenClaw + HeyGen Video 자주 묻는 질문
HeyGen Video API의 모델 ID는 무엇인가요?
model 값으로 heygen-video-1을 보내세요. 텍스트 투 비디오 엔드포인트는 프롬프트와 선택적인 참조 이미지, 영상, 오디오를 받고, 이미지 투 비디오 엔드포인트는 프롬프트와 첫 프레임 이미지를 받습니다.
HeyGen Video는 어떤 입력을 지원하나요?
텍스트 프롬프트, 첫 프레임 이미지, 참조 이미지·영상·오디오를 지원합니다. 출력은 5~15초이며 480p, 768p, 1080p, 2K 중에서 선택할 수 있고 생성된 사운드가 포함됩니다.
HeyGen Video는 사운드도 생성하나요?
네. 대사, 주변음, 효과음이 영상과 같은 요청에서 생성됩니다.
RunAPI에서 HeyGen Video는 어떻게 과금되나요?
영상 길이(초) 기준으로 과금됩니다. 이 페이지의 가격표에서 해상도와 입력 유형별 현재 요금을 확인할 수 있으며, 실패한 생성은 과금되지 않습니다.
HeyGen 아바타 API인가요?
아니요. HeyGen Video는 HeyGen의 범용 영상 모델로, 프롬프트나 이미지로 사운드를 포함한 전체 장면을 만듭니다. 스크립트와 선택한 음성으로 만드는 말하는 아바타 영상은 HeyGen의 별도 아바타 API에서 제공하며, RunAPI는 이를 제공하지 않습니다.
어떤 모델 ID를 사용해야 하나요?
버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.
이 가이드는 채팅 모델을 설정하나요?
아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.