하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
HeyGen Video API
RunAPI를 통해 모델 스킬, 통합 인증, 종량제 요금으로 HeyGen Video API를 사용하세요.
최저 $0.09 / 초
·
2 endpoints
·
상업적 사용 지원
MODEL HEALTH
0 req
runapi.ai
curl -X POST https://runapi.ai/api/v1/heygen_video/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "햇빛이 드는 주방 조리대 위의 도자기 머그컵을 담은 10초 1080p 제품 영상을 생성해 주세요. 참조 이미지로 머그컵 디자인의 일관성을 유지하고 부드러운 주변음을 더해 주세요."
}'import { HeygenVideoClient } from "@runapi.ai/heygen-video";
const client = new HeygenVideoClient();
const result = await client.imageToVideo.run({
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "햇빛이 드는 주방 조리대 위의 도자기 머그컵을 담은 10초 1080p 제품 영상을 생성해 주세요. 참조 이미지로 머그컵 디자인의 일관성을 유지하고 부드러운 주변음을 더해 주세요.",
});require "runapi/heygen_video"
client = RunApi::HeygenVideo::Client.new
result = client.image_to_video.run(
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "햇빛이 드는 주방 조리대 위의 도자기 머그컵을 담은 10초 1080p 제품 영상을 생성해 주세요. 참조 이미지로 머그컵 디자인의 일관성을 유지하고 부드러운 주변음을 더해 주세요."
)npx skills add runapi-ai/heygen-video -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
@runapi.ai/heygen-video
v1
개요
HeyGen Video 소개
HeyGen Video API(모델 ID heygen-video-1)는 5~15초 길이의 영상을 생성하며, 같은 요청에서 대사, 주변음, 효과음도 함께 생성합니다. 텍스트 프롬프트로 생성하거나 첫 프레임 이미지를 애니메이션화할 수 있고, 참조 이미지·영상·오디오로 제품, 인물, 장소의 일관성을 유지할 수 있습니다.
제공사
HeyGen
모달리티
비디오
요금
요금
실패한 생성은 과금되지 않습니다
텍스트로 동영상 생성
$0.04-$0.36
/ 초
과금 입력 모드: standard · 출력 해상도: 2k
$0.18
과금 입력 모드: standard · 출력 해상도: 480p
$0.04
과금 입력 모드: standard · 출력 해상도: 768p
$0.06
과금 입력 모드: standard · 출력 해상도: 1080p
$0.18
과금 입력 모드: reference · 출력 해상도: 2k
$0.36
과금 입력 모드: reference · 출력 해상도: 480p
$0.08
과금 입력 모드: reference · 출력 해상도: 768p
$0.12
과금 입력 모드: reference · 출력 해상도: 1080p
$0.36
이미지로 동영상 생성
$0.02-$0.09
/ 초
출력 해상도: 2k
$0.09
출력 해상도: 480p
$0.02
출력 해상도: 768p
$0.03
출력 해상도: 1080p
$0.09
스펙
스펙
| 모델 ID | heygen-video-1 |
| 제공사 | HeyGen |
| 모달리티 | video |
| 작업 유형 | asynchronous |
| 과금 | 초 |
| Endpoint | /api/v1/heygen_video/image_to_video |
| 상업적 사용 | 예 |
| 카탈로그 상태 | 운영 중 |
에이전트 통합
에이전트에서 HeyGen Video 실행
작동 방식
HeyGen Video 시작하기
-
01
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
02
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
03
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
04
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 HeyGen Video을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
HeyGen Video FAQ
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는 이를 제공하지 않습니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
유사 모델
HeyGen Video와 비슷한 모델
HeyGen Video로 개발을 시작하세요.
endpoint
- text_to_video
- image_to_video