Seedream 5.0 Pro đã ra mắt | Thử trong Trình tạo ảnh →

Hunyuan Avatar

wavespeed-ai /

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.

digital-human
Đầu vào

Chờ

$0.15cho mỗi lần chạy·~66 / $10

Ví dụXem tất cả

Mô hình liên quan

README

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.
Lưu ý:Trang web này sử dụng các mô hình AI do bên thứ ba cung cấp.

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. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Hunyuan Avatar below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
    "resolution": "480p"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "$TASK" | jq -r '.urls.get // empty')
if [ -z "$RESULT_URL" ]; then
  RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "$STATUS" >&2; exit 1 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
        "audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
        "resolution": "480p"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = task.urls?.get ||
  `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout"].includes(result.status)) throw new Error(JSON.stringify(result));
  if (!["created", "processing"].includes(result.status)) throw new Error("Unexpected status: " + result.status);
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
    "resolution": "480p"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-avatar", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = task.get("urls", {}).get("get") or f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout"}:
        raise RuntimeError(result)
    if status not in {"created", "processing"}:
        raise RuntimeError(f"Unexpected status: {status}")
    time.sleep(2)

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 result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. 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?

Median end-to-end generation time on WaveSpeedAI is around 194 seconds per request, based on recent successful runs. Queue time varies 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.

Hunyuan Avatar | AI Digital Human API | WaveSpeedAI