avatar-studio

Generate talking-head videos, lip-sync replacements, and digital avatars via DashScope APIs.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill avatar-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: avatar-studio
Source: https://github.com/openakita/openakita/tree/main/plugins/avatar-studio
Command: npx skills add https://github.com/openakita/openakita --skill avatar-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiosqlite, httpx, pydantic, comfykit, edge-tts.

What problem does it solve?

Creating digital human videos (talking photos, lip-synced dubs, face swaps) normally requires stitching together multiple AI models, TTS engines, and billing logic by hand. This Skill orchestrates the full DashScope pipeline so an agent can produce a finished MP4 from a photo and a sentence of text.

Core Features & Use Cases

  • Five generation modes: photo_speak (talking photo), video_relip (lip-sync replacement), video_reface (person swap), avatar_compose (multi-image character fusion), and pose_drive (motion transfer), with cost preview before any paid submission.
  • Multi-backend and dual TTS: runs on Alibaba DashScope, RunningHub, or local ComfyUI, with CosyVoice or free Edge-TTS for speech synthesis, plus voice cloning and figure libraries.
  • Use Case: A user says "make this headshot say a 5-second welcome message in Chinese" — the Skill runs face detection, synthesizes speech, submits the wan2.2-s2v job, estimates the cost (about ¥0.31), and returns the task id with the finished MP4.

Quick Start

Ask the agent to make the attached portrait photo speak the sentence "Hello, welcome to my channel" using the default voice at 480P resolution.

Frequently Asked Questions about avatar-studio

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

FAQPage Schema
How do I make a photo talk with AI?

Use the photo_speak mode with one frontal portrait image plus either text (synthesized via CosyVoice or Edge-TTS) or an uploaded audio file. The pipeline runs wan2.2-s2v-detect face validation, then wan2.2-s2v to produce a talking-head MP4.

How to replace lip sync in an existing video?

Use the video_relip mode, which calls DashScope videoretalk with your video plus new text or audio. Audio must be between 2 and 120 seconds, and the output is a lip-synced MP4 billed at 0.30 CNY per second.

Does avatar-studio work without a DashScope API key?

Yes, partially. You can switch the backend to RunningHub with its own API key, or to a local ComfyUI instance which runs workflows for free. Edge-TTS also provides free speech synthesis without any paid key.

Why does my avatar task fail with a dependency error?

A dependency error means the input asset was rejected: the image is not a clear frontal human face, or the reference video exceeds duration limits. Replace the asset with a single-person frontal photo and keep reference videos under 30 seconds.

What are the concurrency limits of DashScope video generation?

DashScope allows only one async task in flight per API key, so submissions are serialized through a semaphore. Additional tasks queue until the current one finishes, and task IDs expire after 24 hours on the platform.