Upload a recording to create a voice, then use it in Qwen-Omni or Qwen-Omni-Realtime conversations. This guide covers supported languages, audio requirements, cloning steps, billing, and voice management.
For API parameters, requests, and responses, see the Voice cloning API reference.
Recording quality affects cloning results.
System voices and voice cloning support different dialects. The table below lists the languages and dialects for voice cloning. For system voices, see the voice list.
Create a voice, then use it in a model call:
Select the models, then complete the prerequisites.
Voice cloning requires two models:
This example clones a voice and uses it in a conversation.
Key principle: The
Total limit: 1,000 voices per account.
Voice cloning and model invocation are billed separately:
You are responsible for the ownership and legal use of the voice you provide. Read the Service Agreement.
Use a noise-cancelling microphone, or record with a phone at close range in a quiet environment.
Using a typical bedroom as an example:
This guide covers voice cloning for Qwen-Omni and Qwen-Omni-Realtime. For text-to-speech models, see Speech synthesis.
Audio requirements
Recording quality affects cloning results.
System voices and voice cloning support different dialects. The table below lists the languages and dialects for voice cloning. For system voices, see the voice list.
| Item | Requirement |
|---|---|
| Supported formats | WAV (16-bit), MP3, M4A |
| Duration | 10 to 20 seconds recommended. Maximum: 60 seconds. |
| File size | < 10 MB |
| Sample rate | >= 24 kHz |
| Channels | Mono |
| Content | The audio must contain at least 3 seconds of continuous, clear speech with no background sounds. The remaining portion may include brief pauses (<=2 seconds). Avoid background music, noise, or other voices throughout the entire audio. Use normal spoken audio as input. Don't upload songs or singing audio. |
| Languages | Chinese (zh), English (en), German (de), Italian (it), Portuguese (pt), Spanish (es), Japanese (ja), Korean (ko), French (fr), Russian (ru), Thai (th), Indonesian (id), Arabic (ar), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), Hebrew (he), Hindi (hi), Icelandic (is), Malay (ms), Norwegian (no), Persian (fa), Polish (pl), Swedish (sv), Tagalog (tl), Turkish (tr), Urdu (ur), Vietnamese (vi) Chinese dialects: Dongbei, Shannxi, Sichuan, Henan, Changsha, Tianjin, Hangzhou, Liaoning, Shenyang, Anshan |
Quick start
1. Workflow
Create a voice, then use it in a model call:
-
Create a voice
Call the Create a voice API and upload an audio clip. The system analyzes the audio and creates a custom cloned voice. You must specify
target_modelin this step to declare which omni model will drive the voice. Skip this step if you already have a voice. Check existing voices with the List voices API. -
Use the voice in a conversation
Call the Omni API (realtime or non-realtime) with the created voice. The Omni model must match
target_model.
2. Model configuration and prerequisites
Select the models, then complete the prerequisites.
Model configuration
Voice cloning requires two models:
- Voice cloning model: qwen-voice-enrollment
-
Omni model that drives the voice:
- qwen3.8-omni-flash-realtime
- qwen3.5-omni-plus-realtime
- qwen3.5-omni-flash-realtime
- qwen3.5-omni-plus
- qwen3.5-omni-flash
Prerequisites
- Get an API key: Obtain an API key. For security, configure the API key as an environment variable.
- Install the SDK: Install the latest DashScope SDK.
- Prepare the audio for cloning: The audio must meet the Audio requirements.
3. End-to-end example
This example clones a voice and uses it in a conversation.
Key principle: The target_model specified during cloning must match the model in the subsequent Omni API call. Otherwise, synthesis fails. Replace the example file voice.mp3 with your own audio.
- Realtime
- Non-realtime
Applies to Qwen-Omni-Realtime models. See Qwen-Omni-Realtime.
Python
Voice quota and auto-cleanup
Total limit: 1,000 voices per account.
No dedicated count endpoint exists. Call the List voices API to count your voices.Auto-cleanup: Voices unused for one year are automatically deleted.
Billing
Voice cloning and model invocation are billed separately:
-
Voice cloning: billed at $0.01/voice. Failed creations are not billed.
Free quota (Beijing and Singapore regions only). To claim, query, or use it, see Free quota for new users.
- 1,000 free voice creations within 90 days of activating QwenCloud.
- Failed creations don't consume the free quota.
- Deleting a voice doesn't restore the free quota.
- After the free quota is used up or the 90-day period expires, voice creation is billed at $0.01/voice.
- Conversations with a cloned voice are billed by model token usage. See Model inference pricing.
Copyright and legal compliance
You are responsible for the ownership and legal use of the voice you provide. Read the Service Agreement.
Recording guide
Recording equipment
Use a noise-cancelling microphone, or record with a phone at close range in a quiet environment.
Recording environment
Location
- Record in a small enclosed space of 10 square meters or less.
- Choose a room with sound-absorbing materials such as acoustic foam, carpets, or curtains.
- Avoid large open halls, conference rooms, or classrooms where reverberation is high.
Noise control
- Outdoor noise: Close doors and windows to block traffic, construction, and other external sounds.
- Indoor noise: Turn off air conditioners, fans, and fluorescent light ballasts.
- Record ambient sound with your phone and play it back at high volume to identify hidden noise sources.
Reverberation control
- Reverberation causes audio to sound muffled and reduces clarity.
- Reduce reflections from smooth surfaces: close curtains, open wardrobe doors, and cover desks and shelves with clothing or blankets.
- Use irregular objects such as bookshelves and upholstered furniture to create diffuse reflections.
Script preparation
- Match the script to the target use case. For example, use customer service dialog style for a customer service scenario.
- Make sure the script doesn't contain sensitive or illegal content (such as political, pornographic, or violent material), as this causes cloning to fail.
- Avoid short phrases (such as "hello" or "yes"). Use complete sentences.
- Maintain semantic coherence and avoid frequent pauses when reading. At least 3 consecutive seconds without interruption is recommended.
- You can use the target emotion, such as friendly or serious. Keep the tone natural and avoid exaggerated delivery.
Recommended steps
Using a typical bedroom as an example:
- Close doors and windows to block external noise.
- Turn off air conditioners, fans, and other appliances.
- Close curtains to reduce glass reflections.
- Cover the desk surface with clothing or a blanket to reduce desktop reflections.
- Practice the script, choose the character's tone, and speak naturally.
- Maintain about 10 cm distance from the recording device to avoid plosive distortion or weak signal.