Hunyuan Avatar

Hunyuan Avatar

Playground

Try it 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.

Features

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

ParameterRequiredDescription
audioYesAudio file for lip sync (upload or public URL).
imageYesPortrait image to animate (upload or public URL).
promptNoOptional text to guide expression or style.
resolutionNoOutput resolution: 480p or 720p (default: 480p).
seedNoSet for reproducibility; leave empty for random.

How to Use

  1. Upload your audio — drag and drop a file or paste a public URL.
  2. Upload a portrait image — provide a clear, front-facing photo.
  3. Add a prompt (optional) — describe desired expressions or style. Use the Prompt Enhancer for AI-assisted optimization.
  4. Select resolution — choose 480p for speed or 720p for quality.
  5. Click Run and wait for processing.
  6. 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

ResolutionPrice 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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "480p"
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
audiostringYes--The audio for generating the output.
imagestringYes-The image for generating the output.
promptstringNo-The positive prompt for the generation.
resolutionstringNo480p480p, 720pThe resolution of the output video.
seedintegerNo--1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.