Category: provider

Model Studio CosyVoice Voice Clone

Use the CosyVoice voice enrollment API to create cloned voices from public reference audio.

Critical model names

Use model="voice-enrollment" and one of these target_model values:

• - INLINECODE2
• INLINECODE3
• INLINECODE4
• INLINECODE5
• INLINECODE6

Recommended default in this repo:

• - INLINECODE7

Region and compatibility

• - cosyvoice-v3.5-plus and cosyvoice-v3.5-flash are available only in China mainland deployment mode (Beijing endpoint).
• In international deployment mode (Singapore endpoint), cosyvoice-v3-plus and cosyvoice-v3-flash do not support voice clone/design.
• The target_model used during enrollment must match the model used later in speech synthesis, otherwise synthesis fails.

Endpoint

• - Domestic: INLINECODE13
• International: INLINECODE14

Prerequisites

• - Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.
• Provide a public audio URL for the enrollment sample.

Normalized interface (cosyvoice.voice_clone)

Request

• - model (string, optional): fixed to INLINECODE19
• INLINECODE20 (string, optional): default INLINECODE21
• INLINECODE22 (string, required): letters/digits only, max 10 chars
• INLINECODE23 (string, required): public audio URL
• INLINECODE24 (array[string], optional): only first item is used
• INLINECODE25 (float, optional): only for cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, INLINECODE28
• INLINECODE29 (bool, optional): only for cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, INLINECODE32

Response

• - voice_id (string): use this as the voice parameter in later TTS calls
• INLINECODE35 (string)
• INLINECODE36 (number, optional)

Operational guidance

• - For Chinese dialect reference audio, keep language_hints=["zh"]; control dialect style later in synthesis via text or instruct.
• For cosyvoice-v3.5-plus, supported language_hints include zh, en, fr, de, ja, ko, ru, pt, th, id, vi.
• Avoid frequent enrollment calls; each call creates a new custom voice and consumes quota.

Local helper script

Prepare a normalized request JSON:

CODEBLOCK0

Validation

CODEBLOCK1

Pass criteria: command exits 0 and output/aliyun-cosyvoice-voice-clone/validate.txt is generated.

Output And Evidence

• - Save artifacts, command outputs, and API response summaries under output/aliyun-cosyvoice-voice-clone/.
• Include target_model, prefix, and sample URL in the evidence file.

References

• - INLINECODE56
• INLINECODE57