Attributes
- Provider: alibaba
- Category: Text to Speech
Series
Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| text | Text to synthesize. Required. Max 20,000 Unicode characters. Supports plain text, SSML (set enable_ssml to true), and LaTeX formulas per Alibaba documentation. | string | Yes | - |
| voice | System voice for cosyvoice-v3-plus. Complete set from the Alibaba CosyVoice voice list (https://help.aliyun.com/zh/model-studio/cosyvoice-voice-list). | string | Yes | longanyang, longanhuan |
| aigc_propagate_id | AIGC PropagateID. Only effective when enable_aigc_tag is true. | string | No | - |
| aigc_propagator | AIGC ContentPropagator. Only effective when enable_aigc_tag is true. | string | No | - |
| hot_fix | Text hot-fix before synthesis. Optional object with pronunciation (custom pinyin for Chinese words) and replace (text substitution) arrays per Alibaba HTTP API. | object | No | - |
| instruction | Optional speaking-style instruction for Instruct-capable system voices. Enforced weighted length ≤100 (CJK ideographs / Han count as 2; other characters count as 1). Alibaba requires fixed Chinese formats from the CosyVoice voice list for system voices. | string | No | - |
| bit_rate | Audio bit rate in kbps. Optional. Range 6 to 510. Only supported when format is opus; do not use for mp3, pcm, or wav. | integer | No | - |
| enable_aigc_tag | Embed AIGC invisible watermark into wav/mp3/opus output. Supported on cosyvoice-v3-plus and cosyvoice-v3-flash. | 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 | Audio encoding format. Default mp3. | string | No | mp3, pcm, wav, opus |
| language_hint | Target language hint for pronunciation (numbers, symbols, minor languages). | string | No | zh, en, fr, de, ja, ko, ru, pt, th, id, vi, es, it, ms, fil, ar |
| pitch | Pitch multiplier. Default 1.0. Range 0.5 (lower) to 2.0 (higher). | number | No | - |
| rate | Speech rate multiplier. Default 1.0. Range 0.5 (slow) to 2.0 (fast). | number | No | - |
| sample_rate | Audio sample rate in Hz. Default 22050. | integer | No | 8000, 16000, 22050, 24000, 44100, 48000 |
| seed | Random seed for reproducible synthesis when text, voice, and other parameters are identical. Default 0. Range 0 to 65535. | integer | No | - |
| volume | Output volume. Default 50. Range 0 (silent) to 100 (maximum). | integer | No | - |
Pricing
Unit: $/M chars
| Pricing |
|---|
| $16.0597/M chars |
Related Models
- 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-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.
