--- title: OpenClaw x HeyGen Video 가이드 | RunAPI description: RunAPI를 통해 OpenClaw에서 HeyGen Video을 사용하세요. 현재 모델 ID, 엔드포인트, 가격을 비교하고 알맞은 설정 절차를 확인할 수 있습니다. url: https://runapi.ai/ko/openclaw-heygen-video.md canonical: https://runapi.ai/ko/openclaw-heygen-video locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/openclaw-heygen-video zh-CN: https://runapi.ai/zh-CN/openclaw-heygen-video es: https://runapi.ai/es/openclaw-heygen-video ja: https://runapi.ai/ja/openclaw-heygen-video de: https://runapi.ai/de/openclaw-heygen-video fr: https://runapi.ai/fr/openclaw-heygen-video pt-BR: https://runapi.ai/pt-BR/openclaw-heygen-video ko: https://runapi.ai/ko/openclaw-heygen-video it: https://runapi.ai/it/openclaw-heygen-video nl: https://runapi.ai/nl/openclaw-heygen-video pl: https://runapi.ai/pl/openclaw-heygen-video tr: https://runapi.ai/tr/openclaw-heygen-video zh-TW: https://runapi.ai/zh-TW/openclaw-heygen-video zh-HK: https://runapi.ai/zh-HK/openclaw-heygen-video ar: https://runapi.ai/ar/openclaw-heygen-video x-default: https://runapi.ai/openclaw-heygen-video model_line: heygen-video --- > HTML version: https://runapi.ai/ko/openclaw-heygen-video > Site index for agents: https://runapi.ai/llms.txt [OpenClaw](https://runapi.ai/ko/openclaw.md) / [HeyGen Video](https://runapi.ai/ko/models/heygen-video.md) # OpenClaw x HeyGen Video 텍스트 투 비디오, 이미지 투 비디오, 참조 기반 생성에 하나의 RunAPI 모델 ID를 사용합니다. 출력은 480p부터 2K까지이며, 참조 모드는 이미지 9개, 영상 3개, 오디오 3개까지 지원하고 참조 파일은 총 12개까지입니다. - [API 키 받기](https://runapi.ai/ko/login) - [OpenClaw 문서 보기](https://runapi.ai/ko/docs/guides) 1 variants · 최저 $0.09 / 초 · 상업적 사용 지원 ## Prompt Prerequisite: `npx runapi mcp install` ```text You have access to RunAPI task tools for HeyGen Video. Available HeyGen Video models: - heygen-video-1: heygen-video-1 endpoints: /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video request fields: model, prompt, output_resolution, aspect_ratio Use the model ID and endpoint that match the user's request. Example prompt: 햇빛이 드는 주방 조리대 위의 도자기 머그컵을 담은 10초 1080p 제품 영상을 생성해 주세요. 참조 이미지로 머그컵 디자인의 일관성을 유지하고 부드러운 주변음을 더해 주세요. /api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/text_to_video를 실행하고 반환된 Task ID를 저장합니다. 상태가 completed 또는 failed가 될 때까지 GET /api/v1/heygen_video/text_to_video/를 실행합니다. completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다. /api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/heygen_video/image_to_video를 실행하고 반환된 Task ID를 저장합니다. 상태가 completed 또는 failed가 될 때까지 GET /api/v1/heygen_video/image_to_video/를 실행합니다. completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다. ``` ## 프롬프트 모델 이 가이드에서 HeyGen Video에 RunAPI를 사용하세요. - `heygen-video-1`: heygen-video-1 작업에 맞는 경우 heygen-video-1를 사용하세요: heygen-video-1. ## 공개 버전 및 엔드포인트 | 모델 ID | 버전 | 엔드포인트 | 시작 가격 | | --- | --- | --- | --- | | `heygen-video-1` | 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/를 실행합니다. completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다. ``` ## 설정 `RUNAPI_API_KEY`를 설정하고 ``에 ``가 포함된 요청을 보냅니다. 엔드포인트가 비동기 Task를 반환할 때만 폴링합니다. ```shell 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단계로 시작하기 1. **모델 ID 선택.** 공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다. 2. **RunAPI 설정.** 엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다. 3. **결과 검증.** 비동기 엔드포인트는 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 채팅 모델로 제공되지 않습니다. ## 더 많은 OpenClaw 가이드 - [OpenClaw x Claude](https://runapi.ai/ko/openclaw-claude.md) - Anthropic · 텍스트 · 최저 $0.08 / 100만 토큰 - [OpenClaw x DeepSeek](https://runapi.ai/ko/openclaw-deepseek.md) - DeepSeek · 텍스트 · 최저 $0.30 / 100만 토큰 - [OpenClaw x ElevenLabs](https://runapi.ai/ko/openclaw-elevenlabs.md) - ElevenLabs · 오디오 & 음악 · 최저 $0.03 / 1,000자 - [OpenClaw x Embedding](https://runapi.ai/ko/openclaw-embedding.md) - OpenAI · 텍스트 · 최저 $0.02 / 100만 토큰 ## OpenClaw에서 HeyGen Video 사용 시작하기 - [API 키 받기](https://runapi.ai/ko/login) - [빠른 시작 읽기](https://runapi.ai/ko/docs/guides) ## 팀과 함께 구축하고 계신가요? 엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다. [문의하기](https://runapi.ai/ko/contact.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "OpenClaw x HeyGen Video", "applicationCategory": "DeveloperApplication", "description": "RunAPI를 통해 OpenClaw에서 HeyGen Video을 사용하세요. 현재 모델 ID, 엔드포인트, 가격을 비교하고 알맞은 설정 절차를 확인할 수 있습니다.", "url": "https://runapi.ai/ko/openclaw-heygen-video" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "HeyGen Video API의 모델 ID는 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "model 값으로 heygen-video-1을 보내세요. 텍스트 투 비디오 엔드포인트는 프롬프트와 선택적인 참조 이미지, 영상, 오디오를 받고, 이미지 투 비디오 엔드포인트는 프롬프트와 첫 프레임 이미지를 받습니다." } }, { "@type": "Question", "name": "HeyGen Video는 어떤 입력을 지원하나요?", "acceptedAnswer": { "@type": "Answer", "text": "텍스트 프롬프트, 첫 프레임 이미지, 참조 이미지·영상·오디오를 지원합니다. 출력은 5~15초이며 480p, 768p, 1080p, 2K 중에서 선택할 수 있고 생성된 사운드가 포함됩니다." } }, { "@type": "Question", "name": "HeyGen Video는 사운드도 생성하나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. 대사, 주변음, 효과음이 영상과 같은 요청에서 생성됩니다." } }, { "@type": "Question", "name": "RunAPI에서 HeyGen Video는 어떻게 과금되나요?", "acceptedAnswer": { "@type": "Answer", "text": "영상 길이(초) 기준으로 과금됩니다. 이 페이지의 가격표에서 해상도와 입력 유형별 현재 요금을 확인할 수 있으며, 실패한 생성은 과금되지 않습니다." } }, { "@type": "Question", "name": "HeyGen 아바타 API인가요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. HeyGen Video는 HeyGen의 범용 영상 모델로, 프롬프트나 이미지로 사운드를 포함한 전체 장면을 만듭니다. 스크립트와 선택한 음성으로 만드는 말하는 아바타 영상은 HeyGen의 별도 아바타 API에서 제공하며, RunAPI는 이를 제공하지 않습니다." } }, { "@type": "Question", "name": "어떤 모델 ID를 사용해야 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다." } }, { "@type": "Question", "name": "이 가이드는 채팅 모델을 설정하나요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "OpenClaw에서 HeyGen Video 사용하기", "step": [ { "@type": "HowToStep", "position": 1, "name": "모델 ID 선택", "text": "공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.", "url": "https://runapi.ai/ko/openclaw-heygen-video#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "RunAPI 설정", "text": "엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.", "url": "https://runapi.ai/ko/openclaw-heygen-video#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "결과 검증", "text": "비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.", "url": "https://runapi.ai/ko/openclaw-heygen-video#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "OpenClaw", "item": "https://runapi.ai/ko/openclaw" }, { "@type": "ListItem", "position": 3, "name": "HeyGen Video", "item": "https://runapi.ai/ko/openclaw-heygen-video" } ] } ] ```