Seedream 5.0 Pro 正式上線 | 在圖片生成器中體驗 →

Soulx Flashhead

wavespeed-ai /

SoulX FlashHead enables real-time streaming talking head video generation from portrait image and audio with ultra-fast 96 FPS performance. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

digital-human
輸入

拖放檔案或點擊上傳

preview

拖放檔案或點擊上傳

就緒

$0.075每次運行·~13 / $1

示例查看全部

相關模型

README

SoulX FlashHead

SoulX FlashHead generates realistic talking head videos by combining a portrait image with audio. Upload a face image and audio clip — the model creates a lip-synced video with natural facial movements and expressions. With support for audio clips up to 30 minutes and budget-friendly pricing, it's ideal for long-form talking avatar content.

Why Choose This?

  • Long-form support Generate talking avatar videos with audio up to 30 minutes in length.

  • Realistic lip-sync Accurate lip movements synchronized to the audio input.

  • Natural expressions Creates realistic facial movements and expressions during speech.

  • Budget-friendly Lower cost per second compared to other talking avatar models.

  • Resolution options Choose between 480p and 720p output quality.

Parameters

ParameterRequiredDescription
imageYesPortrait image for the avatar (URL or upload)
audioYesAudio clip for lip-sync (URL or upload, max: 30 min)
resolutionNoOutput resolution: 480p, 720p (default)
seedNoRandom seed for reproducibility (-1 for random)

How to Use

  1. Upload your image — provide a clear portrait image with visible face.
  2. Upload your audio — add the audio clip you want the avatar to speak (up to 30 minutes).
  3. Select resolution — choose 720p for higher quality or 480p for faster/cheaper processing.
  4. Run — submit and download your talking avatar video.

Pricing

Duration720p480p
≤5 s$0.15$0.075
10 s$0.30$0.15
30 s$0.90$0.45
60 s$1.80$0.90
5 min$9.00$4.50

Billing Rules

  • Minimum charge: 5 seconds
  • Maximum duration: 1800 seconds (30 minutes)
  • 480p rate: $0.075 per 5 seconds
  • 720p rate: $0.15 per 5 seconds (2× 480p rate)

Best Use Cases

  • Long-Form Content — Create extended talking avatar videos for podcasts, lectures, and presentations.
  • E-learning — Generate instructor avatars for educational courses and tutorials.
  • Digital Presenters — Produce talking avatars for video presentations and explainers.
  • Marketing & Ads — Create spokesperson videos without filming.
  • Localization — Generate lip-synced videos in different languages from the same avatar.

Pro Tips

  • Use clear, front-facing portrait images with good lighting for best results.
  • Ensure the face is clearly visible and not obscured by hair or accessories.
  • Use high-quality audio with clear speech for accurate lip-sync.
  • Choose 480p for longer content to reduce costs — it still provides good quality.
  • Set a specific seed for reproducible results across multiple generations.

Notes

  • Both image and audio are required fields.
  • Maximum audio duration: 30 minutes (1800 seconds).
  • Minimum charge: 5 seconds (shorter clips billed as 5 seconds).
  • 720p resolution costs 2× the 480p rate.
  • Ensure uploaded file URLs are publicly accessible.

Related Models

Duration limit

The maximum supported audio duration is 10 minutes. Longer audio is automatically trimmed to 10 minutes before processing.

提示:本網站部分功能由第三方 AI 模型提供支援。

Soulx Flashhead API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/soulx-flashhead 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 Soulx Flashhead 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": "720p",
    "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/soulx-flashhead" \
  -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/soulx-flashhead";
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": "720p",
        "seed": -1
}),
});
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": "720p",
    "seed": -1
}

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/soulx-flashhead", 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)

Soulx Flashhead API — Frequently asked questions

What is the Soulx Flashhead API?

Soulx Flashhead is a WaveSpeedAI model for talking-avatar generation, exposed as a REST API on WaveSpeedAI. SoulX FlashHead enables real-time streaming talking head video generation from portrait image and audio with ultra-fast 96 FPS performance. 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 Soulx Flashhead 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/soulx-flashhead.

How much does Soulx Flashhead cost per run?

Soulx Flashhead starts at $0.075 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 Soulx Flashhead accept?

Key inputs: `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/soulx-flashhead.

How long does Soulx Flashhead take to generate?

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

Can I use Soulx Flashhead 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.

Soulx Flashhead | AI Digital Human API | WaveSpeedAI