Communitygithub.com

아바타 비디오

HeyGen의 v2 API를 사용하여 아바타, 음성, 스크립트, 장면, 배경을 정밀하게 제어하는 AI 아바타 비디오를 제작합니다.

아바타 비디오란 무엇인가요?

이 스킬은 HeyGen의 `/v2/video/generate` API를 활용하여, 사용자가 원하는 대로 아바타, 음성, 스크립트, 장면, 배경을 완벽하게 제어하는 AI 아바타 비디오를 생성하는 방법을 제공합니다. 단일 장면 또는 여러 장면으로 구성된 비디오를 제작할 수 있으며, 각 장면마다 다른 배경과 아바타 동작을 설정할 수 있습니다. 주요 기능으로는 아바타 및 음성 목록 조회, 스크립트 작성 및 구조화, 투명 WebM 비디오 생성, 템플릿 사용, 사진 기반 아바타 생성, Remotion과의 통합 등을 지원합니다. 사용자는 선호하는 작업 흐름에 따라 HeyGen MCP 도구(사용 가능한 경우)를 직접 HTTP API 호출보다 우선적으로 사용할 수 있으며, 비디오 생성 후 상태 폴링을 통해 완료를 확인하고 다운로드 URL을 받을 수 있습니다. 이 스킬은 사용자가 아바타와 음성을 직접 선택하고 스크립트를 정확히 작성해야 하는 '정밀 제어' 시나리오에 적합하며, 단순히 비디오 아이디어만 설명하는 경우에는 다른 '비디오 생성' 스킬을 사용하는 것이 좋습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/avatar-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

아바타 비디오은(는) 무엇을 하나요?

아바타, 음성, 스크립트, 장면, 배경을 완벽하게 제어하는 AI 아바타 비디오를 생성합니다. HeyGen의 /v2/video/generate API를 사용하여 단일 또는 다중 장면 비디오를 정확한 설정으로 제작하세요.

인증

모든 요청은 X-Api-Key 헤더가 필요합니다. HEYGEN_API_KEY 환경 변수를 설정하세요.

curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

도구 선택

HeyGen MCP 도구(mcp__heygen__*)를 사용할 수 있다면 직접 HTTP API 호출보다 우선적으로 사용하세요. 이 도구들은 인증 및 요청 형식을 자동으로 처리합니다.

작업MCP 도구대체 (직접 API)
비디오 상태 확인 / URL 가져오기mcp__heygen__get_videoGET /v2/videos/{video_id}
계정 비디오 목록 보기mcp__heygen__list_videosGET /v2/videos
비디오 삭제mcp__heygen__delete_videoDELETE /v2/videos/{video_id}

비디오 생성(POST /v2/video/generate) 및 아바타/음성 목록 조회는 직접 API 호출을 통해 수행됩니다. 아래 참조 파일을 확인하세요.

기본 워크플로우

  1. 아바타 목록 조회 — GET /v2/avatars → 아바타를 선택하고 미리 본 후 avatar_id와 default_voice_id를 기록합니다. avatars.md 참조
  2. 음성 목록 조회(필요 시) — GET /v2/voices → 아바타의 성별/언어와 일치하는 음성을 선택합니다. voices.md 참조
  3. 스크립트 작성 — 각 장면을 하나의 개념으로 구성합니다. scripts.md 참조
  4. 비디오 생성 — POST /v2/video/generate를 사용하여 아바타, 음성, 스크립트, 배경을 장면별로 설정합니다. video-generation.md 참조
  5. 완료 확인 — GET /v2/videos/{video_id}를 호출하여 상태가 completed가 될 때까지 폴링합니다. video-status.md 참조

빠른 참조

작업읽기
아바타 목록 및 미리 보기avatars.md
음성 목록 및 선택voices.md
스크립트 작성 및 구조화scripts.md
비디오 생성(단일 또는 다중 장면)video-generation.md
사용자 정의 배경 추가backgrounds.md
캡션/자막 추가captions.md
텍스트 오버레이 추가text-overlays.md
투명 WebM 비디오 생성video-generation.md (WebM 섹션)
템플릿 사용templates.md
사진으로 아바타 만들기photo-avatars.md
비디오 상태 확인 / 다운로드video-status.md
에셋 업로드(이미지, 오디오)assets.md
Remotion과 함께 사용remotion-integration.md
웹훅 설정webhooks.md

이 스킬을 사용해야 하는 경우 vs 비디오 생성 스킬

이 스킬은 정밀 제어를 위한 것입니다 — 사용자가 직접 아바타를 선택하고, 정확한 스크립트를 작성하며, 각 장면을 구성할 수 있습니다.

사용자가 단순히 비디오 아이디어를 설명하고 나머지(스크립트, 아바타, 시각적 요소)는 AI가 처리하도록 하려면 create-video 스킬을 대신 사용하세요.

사용자 말투비디오 생성 스킬이 스킬
"X에 관한 비디오를 만들어 줘"✓
"제품 데모를 만들어 줘"✓
"아바타 Y가 정확히 Z라고 말하게 해줘"✓
"다양한 배경을 가진 여러 장면 비디오"✓
"합성을 위한 투명 WebM"✓
"내 스크립트에 이 특정 음성을 사용해줘"✓
"정확한 사양으로 비디오 일괄 생성"✓

참조 파일

핵심 비디오 생성

비디오 사용자 정의

고급 기능

통합

기초

모범 사례

  1. 생성 전에 아바타 미리 보기 — preview_image_url을 다운로드하여 사용자가 아바타를 확인할 수 있도록 하세요.
  2. 아바타의 기본 음성 사용 — 대부분의 아바타는 자연스러운 결과를 위해 미리 매칭된 default_voice_id를 가지고 있습니다.
  3. 대체: 수동으로 성별 일치 — 기본 음성이 없는 경우 아바타와 음성의 성별이 일치하는지 확인하세요.
  4. 개발 시 테스트 모드 사용 — test: true를 설정하여 크레딧 소비를 방지하세요(출력에 워터마크가 표시됩니다).
  5. 충분한 타임아웃 설정 — 비디오 생성은 종종 5-15분이 소요되며, 때로는 더 길어질 수 있습니다.
  6. 입력값 검증 — 생성 전에 아바타 및 음성 ID가 존재하는지 확인하세요.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

관련 스킬