ai-avatar-video

Generate talking-head and lip-sync avatar videos from portraits and audio via the RunComfy CLI.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/brillianodhiya/VisionScript --skill ai-avatar-video-brillianodhiya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-avatar-video
Source: https://github.com/brillianodhiya/VisionScript/tree/main/.agents/skills/ai-avatar-video
Command: npx skills add https://github.com/brillianodhiya/VisionScript --skill ai-avatar-video-brillianodhiya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @runcomfy/cli.

What problem does it solve? Creating AI avatar, talking-head, and lip-sync videos requires choosing between multiple audio-driven video models with different input requirements, and this Skill routes each request to the right RunComfy model with the correct prompt pattern and CLI invocation. ## Core Features & Use Cases - Intent-based model routing: Classifies the request (pre-recorded audio vs. script only, photoreal portrait vs. stylized character, single shot vs. cinematic) and selects among OmniHuman, Wan 2-7, Wan 2-2 Animate, HappyHorse 1.0, and Seedance v2 Pro. - Ready-to-run CLI invocations: Ships the exact runcomfy run <model_id> command with documented JSON input bodies for each route. - Use Case: A marketer needs a vertical UGC product ad where a presenter reads a voiceover. The Skill picks OmniHuman, passes the portrait image URL plus the voiceover MP3 URL, and downloads the finished lip-synced video to the output directory. ## Quick Start Ask the agent to make the person in your portrait image speak your voiceover audio file using the ai-avatar-video skill.

Frequently Asked Questions about ai-avatar-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a talking head video from a photo and audio file?▼

Use the OmniHuman route: run `runcomfy run bytedance/omnihuman/api` with an `image_url` for the portrait and an `audio_url` for the voiceover. The model generates a video where the subject speaks or gestures naturally to the audio, with no prompt required.

Which AI avatar model should I use for lip-sync video?▼

OmniHuman is the default for portrait plus audio file jobs. Use Wan 2-7 with `audio_url` for full scene control, Wan 2-2 Animate for stylized characters, HappyHorse 1.0 when you only have a written script, and Seedance v2 Pro for cinematic multi-reference shots.

Can I create a talking avatar video without an audio file?▼

Yes, HappyHorse 1.0 generates speech in-pass from the prompt. Quote the spoken line exactly with `says clearly: "..."` inside the prompt, and optionally describe the audio tone separately, such as a friendly tone with a neutral accent.

Does OmniHuman support multi-language dubbed videos?▼

Yes, you can reuse the same portrait image with a different audio file per language to produce dubbed clips with the same identity. Clean voiceover audio without a music bed gives the best mouth sync quality.

What are the limitations of HappyHorse for lip-sync?▼

HappyHorse regenerates audio on each call, so it cannot lock lip-sync to a specific MP3 file. For precise sync to a pre-recorded track, use OmniHuman or Wan 2-7 with the `audio_url` field instead.

Why did my runcomfy command fail with exit code 77?▼

Exit code 77 means you are not signed in or the token was rejected. Run `runcomfy login` to authenticate, or set the RUNCOMFY_TOKEN environment variable in CI and container environments.