alibaba/cosyvoice-clone

cosyvoice-clone
Docs
Schema

[Core Function] CosyVoice Clone clones a speaker from a public reference audio URL and synthesizes new speech in one async request; only the final audio is returned. [Strengths] No voice enrollment management; language_hint applies to both cloning and synthesis; SSML, hot_fix, and prosody controls. [Best For] One-off cloned narration and demos where a lasting voice library is not needed. [Limitations] Do NOT use this to obtain a reusable voice library entry; the cloned voice is temporary and is not returned. Reference URL must be publicly accessible. model must be cosyvoice-v3.5-plus or cosyvoice-v3.5-flash. [Routing] Choose cosyvoice-v3.5-plus for higher speech quality; cosyvoice-v3.5-flash for lower latency.

$8.0637~$16.0597/M chars
speech-to-speech

Input

Text to synthesize with the temporarily cloned voice. Required. Max 20,000 Unicode characters. Supports plain text and SSML (set enable_ssml to true).
Target CosyVoice v3.5 TTS model used for synthesis after cloning.
model
Publicly accessible reference audio URL for cloning.
Hint: Drag and drop files, paste from clipboard (Ctrl/Cmd+V), or provide a URL.
Text hot-fix before synthesis. Optional object with pronunciation (custom pinyin) and replace (text substitution) arrays, per Alibaba CosyVoice HTTP API.
Optional speaking-style instruction. Weighted length ≤100 (CJK ideographs count as 2).
Audio bit rate in kbps. Optional. Range 6–510. Only supported when format is opus; do not send for mp3, pcm, or wav.
Enable noise reduction and audio enhancement before cloning. Default false.
Whether to parse text as SSML. Default false. When true, text must follow Alibaba CosyVoice SSML rules.
Output audio encoding format. Default mp3.
mp3
Language hint for both cloning and synthesis. Default zh.
zh
Max reference audio duration in seconds used for cloning (3.0–30.0). Default 10.0.
Pitch multiplier. Default 1.0. Range 0.5–2.0.
Speech rate multiplier. Default 1.0. Range 0.5–2.0.
Output sample rate in Hz. Default 22050.
22050
Random seed. Default 0. Range 0–65535.
Output volume. Default 50. Range 0–100.

Result

No results yet

Run the model to preview the output here.

Next:

README

Attributes

Series

Collections

Parameters

Name Description Type Required Enums
text Text to synthesize with the temporarily cloned voice. Required. Max 20,000 Unicode characters. Supports plain text and SSML (set enable_ssml to true). string Yes -
model Target CosyVoice v3.5 TTS model used for synthesis after cloning. string Yes cosyvoice-v3.5-plus, cosyvoice-v3.5-flash
url Publicly accessible reference audio URL for cloning. string Yes -
hot_fix Text hot-fix before synthesis. Optional object with pronunciation (custom pinyin) and replace (text substitution) arrays, per Alibaba CosyVoice HTTP API. object No -
instruction Optional speaking-style instruction. Weighted length ≤100 (CJK ideographs count as 2). string No -
bit_rate Audio bit rate in kbps. Optional. Range 6–510. Only supported when format is opus; do not send for mp3, pcm, or wav. integer No -
enable_preprocess Enable noise reduction and audio enhancement before cloning. Default false. boolean No true, false
enable_ssml Whether to parse text as SSML. Default false. When true, text must follow Alibaba CosyVoice SSML rules. boolean No true, false
format Output audio encoding format. Default mp3. string No mp3, pcm, wav, opus
language_hint Language hint for both cloning and synthesis. Default zh. string No zh, en, fr, de, ja, ko, ru, pt, th, id, vi
max_prompt_audio_length Max reference audio duration in seconds used for cloning (3.0–30.0). Default 10.0. number No -
pitch Pitch multiplier. Default 1.0. Range 0.5–2.0. number No -
rate Speech rate multiplier. Default 1.0. Range 0.5–2.0. number No -
sample_rate Output sample rate in Hz. Default 22050. integer No 8000, 16000, 22050, 24000, 44100, 48000
seed Random seed. Default 0. Range 0–65535. integer No -
volume Output volume. Default 50. Range 0–100. integer No -

Pricing

Unit: $/M chars

Dimension Pricing
model: cosyvoice-v3.5-plus 16.0597
model: cosyvoice-v3.5-flash 8.0637
  • alibaba/cosyvoice-design: [Core Function] CosyVoice Design creates a temporary voice from a natural-language voice_prompt and synthesizes speech in one async request; only the final audio is returned. [Strengths] No voice enrollment management; language_hint (zh/en) applies to both design and synthesis; same prosody and format controls as CosyVoice TTS. [Best For] One-off designed speech without storing enrolled voices. [Limitations] Do NOT use this to obtain a reusable voice library entry; the designed voice is temporary and is not returned. model must be cosyvoice-v3.5-plus or cosyvoice-v3.5-flash; voice_prompt and text are required.
  • alibaba/cosyvoice-v3-flash: [Core Function] CosyVoice v3 Flash is Alibaba’s low-latency text-to-speech model. [Strengths] Rich system voice catalog, fixed-format instruction on Instruct-capable system voices, SSML, hot_fix, AIGC watermark, Markdown filter (cloned voices only), and multiple audio formats with faster turnaround than Plus. [Best For] Voice assistants, interactive prompts, IVR, short announcements, dialect system voices, and latency-sensitive batch TTS. [Limitations] Do NOT use when maximum speech quality or long-form audiobook fidelity is the priority (use Plus). System-voice instruction must follow CosyVoice voice-list fixed Chinese formats. [Routing] Choose Flash when speed or a richer system-voice catalog matters most. Choose Plus for premium narration quality.
  • alibaba/cosyvoice-v3-plus: [Core Function] CosyVoice v3 Plus is Alibaba’s high-quality text-to-speech model. [Strengths] System voices (e.g. longanyang, longanhuan), SSML and LaTeX input, hot_fix pronunciation correction, AIGC watermark, and output in mp3, pcm, wav, or opus. System-voice instruction must use the fixed Chinese formats in the CosyVoice voice list. [Best For] Brand voiceovers, audiobooks, high-quality narration, marketing clips, and scenarios where speech quality matters more than minimum latency. [Limitations] Do NOT use for real-time streaming or word-level timestamps. Fewer system voices than Flash. [Routing] Choose Plus when quality or narration fidelity matters most. Choose cosyvoice-v3-flash for lower latency or a richer system-voice catalog.
  • minimax/minimax-voice-clone: [Core Function] MiniMax Voice Clone clones a speaker from a public reference audio URL and synthesizes new speech in one async request; only the final audio is returned. [Strengths] No voice enrollment management; optional language_boost for clone and synthesis; prosody controls (speed, volume, pitch, emotion); pronunciation overrides; voice effects; flexible audio formats. [Best For] One-off cloned narration, personalized prompts, and demos where a lasting voice library is not needed. [Limitations] Do NOT use this to obtain a reusable voice library entry; the cloned voice is temporary and is not returned. audio_url must be publicly reachable (mp3/m4a/wav, 10s–5min, ≤20 MB). [Routing] Choose speech-2.8-hd for higher quality; speech-2.8-turbo for lower latency or cost. Paralinguistic tags such as (laughs) in text are supported on both speech-2.8-hd and speech-2.8-turbo.

Related Resources