Communitygithub.com

Zuhair-01/claude-skills-and-systems

使用 HeyGen v2 API 建立 AI 虛擬人物影片,精準控制虛擬人物、聲音、腳本、場景與背景。適用於:選擇特定虛擬人物與聲音、撰寫精確腳本、建置多場景影片、建立透明 WebM 影片、使用照片虛擬人物、整合 HeyGen 與 Remotion、批次生成影片、以及製作符合品牌形象的精確影片。

claude-skills-and-systems 是什麼?

此技能提供開發者透過 HeyGen v2 API,以精準控制的方式建立 AI 虛擬人物影片。它涵蓋從選擇虛擬人物、聲音、編寫腳本、設定多場景背景到生成最終影片的完整流程。支援功能包含透明 WebM 影片合成、照片虛擬人物、與 Remotion 整合、以及批次影片生成。技能強烈建議優先使用 HeyGen MCP 工具(如 `mcp__heygen__get_video`)以自動處理驗證與請求格式,若無法使用則回退至直接 HTTP API 呼叫。透過詳細的參考檔案(如 `avatars.md`、`voices.md`、`scripts.md`、`video-generation.md` 等),可實現包括字幕、文字覆蓋、範本、網路鉤子等進階自訂。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/avatar-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

虛擬人物影片

使用 HeyGen /v2/video/generate API,以完整控制虛擬人物、聲音、腳本、場景與背景,建立 AI 虛擬人物影片。可建置單一或多場景影片,並精確設定組態。

驗證

所有請求都需要 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)
檢查影片狀態 / 取得網址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.

相關技能