--- id: daily-avatar-video name: "avatar-video" url: https://skills.yangsir.net/skill/daily-avatar-video author: heygen-com domain: multimedia tags: ["ai-video", "avatar", "text-to-speech", "video-generation", "heygen"] install_count: 994 rating: 4.20 (58 reviews) github: https://github.com/heygen-com/skills --- # avatar-video > 创建 AI 头像视频，完全控制头像、声音、脚本、场景和背景，使用 HeyGen /v2/video/generate API 构建单场景或多场景视频 **Stats**: 994 installs · 4.2/5 (58 reviews) ## Before / After 对比 ### 使用效果对比 **Before**: 手动完成创建 AI 头像视频，完全控制相关任务，需要反复操作和确认，整个过程大约需要41小时，容易出错且效率低下 **After**: 使用该 Skill 自动化处理，智能分析和执行，2小时内完成全部工作，准确率高且流程标准化 | Metric | Before | After | Change | |---|---|---|---| | 耗时减少 | 41小时 | 2小时 | -95% | ## Readme # avatar-video # Avatar Video Create AI avatar videos with full control over avatars, voices, scripts, scenes, and backgrounds. Build single or multi-scene videos with exact configuration using HeyGen's `/v2/video/generate` API. ## Authentication All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable. ``` curl -X GET "https://api.heygen.com/v2/avatars" \ -H "X-Api-Key: $HEYGEN_API_KEY" ``` ## Tool Selection If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically. Task MCP Tool Fallback (Direct API) Check video status / get URL `mcp__heygen__get_video` `GET /v2/videos/{video_id}` List account videos `mcp__heygen__list_videos` `GET /v2/videos` Delete a video `mcp__heygen__delete_video` `DELETE /v2/videos/{video_id}` Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below. ## Default Workflow - **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/avatars.md) - **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/voices.md) - **Write the script** — Structure scenes with one concept each. See [scripts.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/scripts.md) - **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-generation.md) - **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-status.md) ## Quick Reference Task Read List and preview avatars [avatars.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/avatars.md) List and select voices [voices.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/voices.md) Write and structure scripts [scripts.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/scripts.md) Generate video (single or multi-scene) [video-generation.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-generation.md) Add custom backgrounds [backgrounds.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/backgrounds.md) Add captions / subtitles [captions.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/captions.md) Add text overlays [text-overlays.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/text-overlays.md) Create transparent WebM video [video-generation.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-generation.md) (WebM section) Use templates [templates.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/templates.md) Create avatar from photo [photo-avatars.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/photo-avatars.md) Check video status / download [video-status.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-status.md) Upload assets (images, audio) [assets.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/assets.md) Use with Remotion [remotion-integration.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/remotion-integration.md) Set up webhooks [webhooks.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/webhooks.md) ## When to Use This Skill vs Create Video This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene. If the user just wants to **describe a video idea** and let AI handle the rest (script, avatar, visuals), use the **create-video** skill instead. User Says Create Video Skill This Skill "Make me a video about X" ✓ "Create a product demo" ✓ "I want avatar Y to say exactly Z" ✓ "Multi-scene video with different backgrounds" ✓ "Transparent WebM for compositing" ✓ "Use this specific voice for my script" ✓ "Batch generate videos with exact specs" ✓ ## Reference Files ### Core Video Creation - [references/avatars.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-generation.md) - POST /v2/video/generate and multi-scene videos ### Video Customization - [references/backgrounds.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/captions.md) - Auto-generated captions and subtitles ### Advanced Features - [references/templates.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/webhooks.md) - Webhook endpoints and events ### Integration - [references/remotion-integration.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/remotion-integration.md) - Using HeyGen in Remotion compositions ### Foundation - [references/video-status.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/video-status.md) - Polling patterns and download URLs - [references/assets.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/assets.md) - Uploading images, videos, audio - [references/dimensions.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/dimensions.md) - Resolution and aspect ratios - [references/quota.md](https://github.com/heygen-com/skills/blob/HEAD/skills/avatar-video/references/quota.md) - Credit system and usage limits ## Best Practices - **Preview avatars before generating** — Download `preview_image_url` so the user can see the avatar before committing - **Use avatar's default voice** — Most avatars have a `default_voice_id` pre-matched for natural results - **Fallback: match gender manually** — If no default voice, ensure avatar and voice genders match - **Use test mode for development** — Set `test: true` to avoid consuming credits (output will be watermarked) - **Set generous timeouts** — Video generation often takes 5-15 minutes, sometimes longer - **Validate inputs** — Check avatar and voice IDs exist before generating Weekly Installs234Repository[heygen-com/skills](https://github.com/heygen-com/skills)GitHub Stars91First Seen8 days agoSecurity Audits[Gen Agent Trust HubPass](/heygen-com/skills/avatar-video/security/agent-trust-hub)[SocketPass](/heygen-com/skills/avatar-video/security/socket)[SnykPass](/heygen-com/skills/avatar-video/security/snyk)Installed onclaude-code225codex37cline35gemini-cli35kimi-cli35cursor35 --- *Source: https://skills.yangsir.net/skill/daily-avatar-video* *Markdown mirror: https://skills.yangsir.net/api/skill/daily-avatar-video/markdown*