Zonos2

Zonos2

Playground

Try it on WavespeedAI!

Zonos2 is a fast multilingual voice-cloning text-to-speech model that generates natural speech from text using a short reference audio sample. Ready-to-use REST inference API for voice cloning, multilingual TTS, narration, dubbing, character dialogue, virtual assistants, creator content, and professional speech generation workflows with simple integration, no coldstarts, and affordable pricing.

Features

Zonos2 Voice Cloning Text-to-Speech

Zonos2 Voice Cloning Text-to-Speech is an open-source, real-time text-to-speech model from Zyphra. It clones a voice from a short reference audio sample and synthesizes the supplied text in the cloned voice.


Why Choose This?

  • Voice cloning from reference audio
    Clone a speaker’s voice from a short audio sample and generate speech from text.

  • Real-time text-to-speech model
    Built on Zonos2, an open-source real-time TTS model from Zyphra.

  • Background cleanup option
    Use clean_speaker_background when the reference audio has a clean background.

  • Standard audio output
    The generated audio is returned as a URL in the standard WaveSpeed prediction response.


Parameters

ParameterRequiredDescription
audioYesReference audio URL used to clone the voice. A short, clear sample works best.
textYesText to synthesize in the cloned voice.
clean_speaker_backgroundNoEnable when the reference audio has a clean background.

How to Use

  1. Upload reference audio — Provide a short, clear audio sample of the speaker voice you want to clone.
  2. Enter text — Provide the text that should be spoken in the cloned voice.
  3. Set background option (optional) — Enable clean_speaker_background when the reference audio has a clean background.
  4. Submit — Generate the cloned-voice speech output.

Output

Returns generated audio URL(s) in the standard WaveSpeed prediction response.

The generated audio is returned as WAV, 44.1kHz mono.


Pricing

Pricing is $0.01 per minute.

Reference Audio DurationBilled MinutesPrice
0-60s1$0.01
61-120s2$0.02
121-180s3$0.03

Billing Rules

  • Billing is based on the reference audio duration.
  • Reference audio duration is rounded up to the next full minute.
  • Minimum billing duration is 1 minute.
  • Each billed minute costs $0.01.

Best Use Cases

  • Voice cloning TTS — Generate speech in a cloned voice from a reference audio sample.
  • Narration generation — Create spoken narration from text using a target speaker voice.
  • Dialogue prototyping — Test voice lines, character speech, or script variations.
  • Localized speech generation — Use supported language normalization codes for multilingual text handling.
  • Audio content creation — Generate voice audio for videos, demos, apps, or creative workflows.

Pro Tips

  • Use clean reference audio with minimal background noise for better cloning quality.
  • Use a short and clear speaker sample for more stable voice cloning.
  • Make sure the reference audio contains the target speaker clearly.
  • Enable clean_speaker_background only when the reference audio has a clean background.
  • Ensure the audio URL is publicly accessible.

Notes

  • audio and text are required fields.
  • Provider sampling settings use the default mapping values.

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/zonos2" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "clean_speaker_background": false
}'

# 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--Reference audio URL used to clone the voice.
textstringYes--Text to synthesize in the cloned voice.
clean_speaker_backgroundbooleanNofalse-Enable when the reference audio has a clean background.

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