Hunyuan Avatar

Hunyuan Avatar is an advanced audio-driven avatar generation model that creates talking head videos from a single image and audio track. Upload a portrait and audio file, and the model generates a realistic video with synchronized lip movements, facial expressions, and natural head motion.

Why It Stands Out

Audio-driven animation: Generates realistic talking head videos synced to any audio track.
Single image input: Create animated avatars from just one portrait photo.
Natural expressions: Produces lifelike facial movements, lip sync, and subtle head motion.
Prompt support: Add optional prompts to guide style and expression. Use the Prompt Enhancer for optimization.
Resolution options: Choose between 480p for faster processing or 720p for higher quality.
Reproducibility: Use the seed parameter to recreate exact results.

Parameters

Parameter	Required	Description
audio	Yes	Audio file for lip sync (upload or public URL).
image	Yes	Portrait image to animate (upload or public URL).
prompt	No	Optional text to guide expression or style.
resolution	No	Output resolution: 480p or 720p (default: 480p).
seed	No	Set for reproducibility; leave empty for random.

How to Use

Upload your audio — drag and drop a file or paste a public URL.
Upload a portrait image — provide a clear, front-facing photo.
Add a prompt (optional) — describe desired expressions or style. Use the Prompt Enhancer for AI-assisted optimization.
Select resolution — choose 480p for speed or 720p for quality.
Click Run and wait for processing.
Preview and download the animated avatar video.

Best Use Cases

Virtual Presenters — Create AI spokespersons for videos and presentations.
Content Creation — Generate talking head videos for social media and YouTube.
E-learning — Produce instructor videos from static photos and voiceovers.
Marketing & Advertising — Create personalized video messages at scale.
Localization — Generate multilingual versions of spokesperson videos.
Customer Service — Build animated avatars for video FAQs and support content.

Pricing

Resolution	Price per 5 seconds
480p	$0.15
720p	$0.30

Total cost = (audio duration in seconds / 5) × price per 5 seconds

Billing Rules

Minimum charge: 5 seconds
Maximum billable duration: 120 seconds (2 minutes)

Examples (480p)

5s audio → $0.15 (minimum)
10s audio → $0.30
30s audio → $0.90
60s audio → $1.80
2 min (120s) audio → $3.60 (maximum)

Examples (720p)

5s audio → $0.30 (minimum)
10s audio → $0.60
30s audio → $1.80
60s audio → $3.60
2 min (120s) audio → $7.20 (maximum)

Pro Tips for Best Quality

Use clear, front-facing portrait photos with good lighting.
Ensure the face is centered and not obscured by hair or accessories.
Use high-quality audio with clear speech for best lip sync.
Choose 480p for drafts and quick iterations, 720p for final delivery.
Neutral expressions in the source image allow for more natural animation.

Notes

Ensure uploaded audio and image URLs are publicly accessible.
Maximum billable duration is 120 seconds (2 minutes) per job.
Processing time varies based on audio length, resolution, and current queue load.
Please ensure your content complies with usage guidelines.

Hunyuan Avatar API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Hunyuan Avatar below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "audio": "https://example.com/your-audio.mp3",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "480p",
    "seed": 0
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/hunyuan-avatar", {
        "image": "https://example.com/your-input.jpg",
        "audio": "https://example.com/your-audio.mp3",
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "resolution": "480p",
        "seed": 0
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/hunyuan-avatar",
    {
    "image": "https://example.com/your-input.jpg",
    "audio": "https://example.com/your-audio.mp3",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "480p",
    "seed": 0
}
)

print(output["outputs"][0])  # → URL of the generated output

Hunyuan Avatar API — Frequently asked questions

What is the Hunyuan Avatar API?

Hunyuan Avatar is a WaveSpeedAI model for talking-avatar generation, exposed as a REST API on WaveSpeedAI. Hunyuan Avatar creates audio-driven talking or singing videos from one image + audio, in 480p/720p up to 120s (starts at $0.15/5s). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Hunyuan Avatar API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hunyuan-avatar.

How much does Hunyuan Avatar cost per run?

Hunyuan Avatar starts at $0.15 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Hunyuan Avatar accept?

Key inputs: `prompt`, `image`, `audio`, `resolution`, `seed`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hunyuan-avatar.

How long does Hunyuan Avatar take to generate?

Average end-to-end generation time on WaveSpeedAI is around 167 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Hunyuan Avatar outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README