Communitygithub.com

Zuhair-01/claude-skills-and-systems

利用 HeyGen v2 API 创建 AI 虚拟人视频,精确控制虚拟人物、声音、脚本、场景和背景。适用于:选择特定虚拟人物和声音、编写精确脚本、构建多场景视频、创建透明 WebM 视频、使用真人照片作为视频主持人、集成 HeyGen 虚拟人与 Remotion、批量生成视频以及制作品牌一致的视频。

claude-skills-and-systems 是什么?

这个技能使开发者能够通过 HeyGen 的 `/v2/video/generate` API 创建完全可控的 AI 虚拟人视频。它支持单场景和多场景视频,允许用户精确选择虚拟人物(包括从照片创建)、调整声音(语速、音调)、编写带有停顿和节奏的脚本,以及为每个场景设置独立背景(纯色、图片或视频)。此外,它还支持添加字幕、文本叠加,以及生成透明 WebM 格式视频用于后期合成。该技能是 HeyGen MCP 工具的补充:如果 MCP 工具可用,应优先用于视频状态检查、列表和删除操作;而视频生成和虚拟人物/声音列表则通过直接 API 调用完成。详细的工作流程包括:列出并预览虚拟人物、选择或匹配声音、结构化编写脚本、生成视频并轮询完成状态。此技能特别适用于需要精细控制的场景,如品牌一致性视频、批量生成或与 Remotion 集成,而对于“用 AI 自动生成视频”的简单需求,则应使用 create-video 技能。

兼容平台✓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)
检查视频状态 / 获取 URLmcp__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
设置 Webhookwebhooks.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.

相关技能