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 or cloned voice ID for cosyvoice-v3-flash. Full official CosyVoice voice catalog (use only voices listed under cosyvoice-v3-flash for system voices): https://help.aliyun.com/zh/model-studio/cosyvoice-voice-list . Do not mix Plus and Flash system voices. Cloned or designed voice IDs are also accepted. Sample system voices (not exhaustive): longanyang, longhuhu_v3, longpaopao_v3, longshanshan_v3, longjiaxin_v3, loongkyong_v3, longfei_v3, longyingxiao_v3, longyingxun_v3, longxiaochun_v3, longantai_v3, longmiao_v3, longjiqi_v3, longanran_v3, longshuo_v3. | string | Yes | - |
| 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 | - |
| enable_markdown_filter | Filter Markdown markers before synthesis. Only supported on cosyvoice-v3-flash with cloned voices. | boolean | No | true, false |
Pricing
Input image ($/img): 0.0000
Input video ($/sec): 0.0000
Unit: $/M chars
| Pricing |
|---|
| $13.0000/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-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.
