Attributes
- Provider: alibaba
- Category: Text to Speech
Series
Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| text | Text to synthesize with the temporarily designed voice. Required. Max 20,000 Unicode characters. | string | Yes | - |
| voice_prompt | Natural-language voice description (Chinese or English). Required. Max 500 Unicode characters. | string | Yes | - |
| model | Target CosyVoice v3.5 TTS model used for synthesis after voice design. | string | Yes | cosyvoice-v3.5-plus, cosyvoice-v3.5-flash |
| hot_fix | Text hot-fix before synthesis. Same as CosyVoice TTS hot_fix. | 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. | integer | No | - |
| enable_ssml | Whether to parse text as SSML. Default false. | boolean | No | true, false |
| format | Output audio encoding format. Default mp3. | string | No | mp3, pcm, wav, opus |
| language_hint | Language hint for both design and synthesis (zh/en only). Default zh. | string | No | zh, en |
| 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 |
Related Models
- 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.
- alibaba/cosyvoice-clone: [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.
