Voice cloning HTTP API reference

更新时间:
复制 MD 格式

Use the HTTP API to create, list, query, update, and delete cloned voices.

User guide: Voice cloning.

Service endpoint (Qwen-Audio-TTS/CosyVoice/Qwen-TTS)

China (Beijing)

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization

Replace {WorkspaceId} with your actual workspace ID.

Singapore

POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization

Replace {WorkspaceId} with your actual workspace ID.

Important

Alibaba Cloud Model Studio has released workspace-specific domains for the China (Beijing) and Singapore regions. The new dedicated domains deliver superior performance and higher stability for inference requests. We recommend migrating to the new domains:

  • China (Beijing): from dashscope.aliyuncs.com to {WorkspaceId}.cn-beijing.maas.aliyuncs.com

  • Singapore: from dashscope-intl.aliyuncs.com to {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

Replace {WorkspaceId} with your actual Workspace ID. The existing domains remain fully functional.

Service endpoint (MiniMax)

HTTP request URL: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

base_url for SDK calls: https://dashscope.aliyuncs.com/api/v1

Third-party models (MiniMax) currently only support access through the dashscope.aliyuncs.com domain and do not support dedicated endpoints.

Request headers

Parameter

Type

Required

Description

Authorization

string

Yes

Authentication token in the format Bearer <your_api_key>. Replace <your_api_key> with your actual API key.

Content-Type

string

Yes

Media type of the request body. Set to application/json for Qwen-Audio-TTS/CosyVoice/Qwen-TTS, or application/json; charset=utf-8 for MiniMax.

Create a voice (Qwen-Audio-TTS/CosyVoice/Qwen-TTS)

Request body

This example uses the Beijing region endpoint. For the Singapore region, use: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization.

Replace {WorkspaceId} with your actual workspace ID.

Qwen-Audio-TTS/CosyVoice voice cloning

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "create_voice",
        "target_model": "qwen-audio-3.0-tts-plus",
        "prefix": "myvoice",
        "url": "https://your-audio-url.wav",
        "language_hints": ["en"]
    }
}'

Qwen-TTS voice cloning

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-voice-enrollment",
    "input": {
        "action": "create",
        "target_model": "qwen3-tts-vc-realtime-2026-01-15",
        "preferred_name": "myvoice",
        "audio": {"data": "data:audio/mpeg;base64,{base64_encoded_audio}"}
    }
}'

model string (required)

The voice cloning model. Valid values:

  • voice-enrollment: Qwen-Audio-TTS/CosyVoice voice cloning.

  • qwen-voice-enrollment: Qwen-TTS voice cloning.

input object (required)

The input parameters.

Properties

action string (required)

The action type.

  • Qwen-Audio-TTS/CosyVoice (voice-enrollment): Set to create_voice.

  • Qwen (qwen-voice-enrollment): Set to create.

target_model string (required)

The text-to-speech (TTS) model that drives the cloned voice. It must match the model you specify when calling the TTS API; otherwise, synthesis fails.

url string (conditionally required)

Important

Applies only to Qwen-Audio-TTS/CosyVoice voice cloning (when model is voice-enrollment).

The URL of the audio file for voice cloning. The URL must be publicly accessible.

audio object (conditionally required)

Important

Applies only to Qwen-TTS voice cloning (when model is qwen-voice-enrollment).

The audio data. Two submission methods are supported:

  • Data URL (Base64-encoded): Format is {"data": "data:{mime_type};base64,{base64_encoded_data}"}. Supported MIME types: audio/wav, audio/mpeg, and audio/mp4.

  • Audio URL: Format is {"data": "https://your-audio-url.wav"}. The URL must be publicly accessible without authentication.

text string (optional)

Important

Applies only to Qwen-TTS voice cloning (when model is qwen-voice-enrollment).

The transcript of the audio, used to improve cloning quality.

prefix string (conditionally required)

Important

Applies only to Qwen-Audio-TTS/CosyVoice (when model is voice-enrollment).

A prefix for the voice name. Only alphanumeric characters are allowed, with a maximum length of 10 characters. The resulting voice name follows this format: {target_model}-{prefix}-{unique_id}.

preferred_name string (conditionally required)

Important

Applies only to Qwen-TTS voice cloning (when model is qwen-voice-enrollment).

A prefix for the voice name. Only alphanumeric characters and underscores are allowed, with a maximum length of 16 characters.

language_hints array[string] (optional)

Important

Applies only to Qwen-Audio-TTS/CosyVoice voice cloning (when model is voice-enrollment). Supported only by qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, cosyvoice-v3.5-plus, v3.5-flash, v3-plus, and v3-flash.

Helps the model identify the language of the sample audio to extract voice features more accurately and improve cloning quality. If the specified language doesn't match the actual audio language (for example, setting en when the audio is in Chinese), the system ignores this value and detects the language automatically.

This parameter is an array, but the current version processes only the first element.

Valid values vary by model:

  • qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash:

    • zh: Chinese

    • en: English

    • fr: French

    • de: German

    • ja: Japanese

    • ko: Korean

    • ru: Russian

    • pt: Portuguese

    • th: Thai

    • id: Indonesian

    • vi: Vietnamese

    • it: Italian

    • ms: Malay

  • cosyvoice-v3-plus:

    • zh: Chinese

    • en: English

    • fr: French

    • de: German

    • ja: Japanese

    • ko: Korean

    • ru: Russian

  • cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-flash:

    • zh: Chinese

    • en: English

    • fr: French

    • de: German

    • ja: Japanese

    • ko: Korean

    • ru: Russian

    • pt: Portuguese

    • th: Thai

    • id: Indonesian

    • vi: Vietnamese

Default: ["zh"].

language string (optional)

Important

Applies only to Qwen-TTS voice cloning (when model is qwen-voice-enrollment).

The language of the audio provided in audio.data. If you use this parameter, make sure the specified language matches the actual language of the audio used for cloning.

Valid values:

  • zh: Chinese

  • en: English

  • de: German

  • it: Italian

  • pt: Portuguese

  • es: Spanish

  • ja: Japanese

  • ko: Korean

  • fr: French

  • ru: Russian

Default: zh.

max_prompt_audio_length float (optional)

Important

Applies only to Qwen-Audio-TTS/CosyVoice voice cloning (when model is voice-enrollment). Supported only by qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, cosyvoice-v3.5-plus, v3.5-flash, and v3-flash.

The maximum duration (in seconds) of the reference audio after preprocessing. Valid values: [3.0, 30.0]. Longer durations produce better results.

Default: 10.0.

enable_preprocess boolean (optional)

Important

Applies only to Qwen-Audio-TTS/CosyVoice voice cloning (when model is voice-enrollment). Supported only by qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, cosyvoice-v3.5-plus, v3.5-flash, and v3-flash.

Whether to enable audio preprocessing (noise reduction, audio enhancement, and volume normalization). Enable this for recordings with background noise. Disable it for recordings in quiet environments to preserve the original voice characteristics.

Default: false.

Response body

Qwen-Audio-TTS/CosyVoice voice cloning

{
    "output": {
        "voice_id": "qwen-audio-3.0-tts-plus-myvoice-xxxxxx"
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

Qwen-TTS voice cloning

{
    "output": {
        "voice": "yourVoice",
        "target_model": "qwen3-tts-vc-realtime-2026-01-15"
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}
Important

Qwen-Audio-TTS/CosyVoice returns the voice_id field, while Qwen returns the voice field. Qwen-TTS voice cloning may also return the fallback_mode and fallback_reason fields.

request_id string

The unique identifier of this request.

output object

The data returned by the model.

Properties

voice_id / voice string

The voice ID. Qwen-Audio-TTS/CosyVoice returns voice_id, while Qwen returns voice. Use this value directly in the voice parameter of the TTS API.

target_model string

Important

Returned only by Qwen.

The TTS model that drives the cloned voice.

fallback_mode boolean

Important

Applies only to Qwen-TTS voice cloning (when model is qwen-voice-enrollment).

Whether the voice was created in fallback mode. A value of true indicates that the audio quality was poor or didn't match the provided text, and the cloning quality may be reduced.

fallback_reason string

Important

Returned only when fallback_mode is true.

The reason for the fallback. Possible values include no_merged_segments (unable to merge audio segments) and no_valid_asr_segments (severe mismatch between audio and text).

usage object

Usage information for this request.

Properties

count integer

The number of voices created. Always 1.

Create a voice (MiniMax)

A voice cloning request generates a demo audio clip. The demo audio is billed at the synchronous TTS rate of the selected model.

Request body

# Third-party models (MiniMax) currently only support dashscope.aliyuncs.com
curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
    "input": {
      "action": "voice_clone",
      "voice_id": "bailian-test-voice-22",
      "audio_url": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/cosyvoice/cosyvoice-zeroshot-sample.wav",
      "text": "How is the weather today?"
    },
    "model": "MiniMax/speech-2.8-turbo"
  }'

model string (required)

The speech model used to generate the demo audio.

Supported models:

  • MiniMax/speech-2.8-hd

  • MiniMax/speech-02-hd

  • MiniMax/speech-2.8-turbo

  • MiniMax/speech-02-turbo

input object (required)

Properties

action string (required)

The operation to perform. Set to voice_clone for voice cloning.

audio_url string (required)

The URL of the audio file to clone. The audio must meet the following requirements:

  • Format: mp3, m4a, or wav

  • Duration: at least 10 seconds and no more than 5 minutes

  • File size: no more than 20 MB

clone_prompt object (optional)

A sample audio clip for voice cloning. Providing this parameter improves voice similarity and stability during synthesis.

Properties

prompt_audio string (optional)

The URL of the sample audio file. The audio must meet the following requirements:

  • Format: mp3, m4a, or wav

  • Duration: less than 8 seconds

  • File size: no more than 20 MB

prompt_text string (optional)

The transcript of the sample audio. The text must match the audio content exactly and end with a punctuation mark.

text string (required)

The text to synthesize as demo audio for the cloned voice. Maximum: 1,000 characters.

The demo audio is billed at the standard TTS rate per character. For pricing details, see MiniMax model pricing.
  • Interjection tags: When using speech-2.8-hd or speech-2.8-turbo, you can insert interjection tags in the text. Supported interjections: (laughs) (laughter), (chuckle) (chuckle), (coughs) (cough), (clear-throat) (throat clearing), (groans) (groan), (breath) (normal breath), (pant) (panting), (inhale) (inhale), (exhale) (exhale), (gasps) (gasp), (sniffs) (sniff), (sighs) (sigh), (snorts) (snort), (burps) (burp), (lip-smacking) (lip smacking), (humming) (humming), (hissing) (hissing), (emm) (hesitation), (whistles) (whistle), (sneezes) (sneeze), (crying) (crying), (applause) (applause)

voice_id string (required)

The ID of the cloned voice (for example, "MiniMax001"). The ID must follow these naming rules:

  • Length: 8 to 256 characters

  • Must start with a letter

  • Allowed characters: letters, digits, hyphens (-), and underscores (_)

  • Must not end with a hyphen (-) or underscore (_)

  • Must be unique across all existing voice IDs. Duplicate IDs return an error.

The voice ID must be globally unique across all voices in your account. Include a timestamp or other unique identifier in the ID to avoid conflicts.

language_boostenum<string>(optional) Default: null

Whether to enhance recognition accuracy for a specific language or dialect. Set to auto to let the model detect the language automatically.

Available options

Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans,auto

need_noise_reduction boolean (optional) Default: false

Whether to enable noise reduction for the audio used for cloning.

need_volume_normalizationboolean (optional) Default: false

Whether to enable volume normalization.

aigc_watermarkboolean (optional) Default: false

Whether to add an AI watermark to the synthesized demo audio.

Response body

{
    "output": {
        "base_resp": {
            "status_code": 0,
            "status_msg": "success"
        },
        "demo_audio": "https://minimax-algeng-chat-tts.oss-cn-wulanchabu.aliyuncs.com/audio%2Feffect%2F05fdf023562aea84632d2a8c01c2366f_1773059375796_1311.mp3?Expires=1773232175&OSSAccessKeyId=LTAI************&Signature=z2GwvhFZ3d33BggWRGU8Jb24sZA%3D",
        "input_sensitive": false,
        "input_sensitive_type": 0
    },
    "usage": {
        "characters": 18
    },
    "request_id": "b1160386-ebf1-913f-9275-ef176c5e1c91"
}

request_id string

The unique identifier of this request.

output object

Properties

input_sensitiveboolean

Whether the input audio triggered content moderation.

input_sensitive_type integer

The type of content moderation violation detected in the input audio:

  • 0: Normal (no violation)

  • 1: Severe violation

  • 2: Pornographic content

  • 3: Advertising

  • 4: Prohibited content

  • 5: Abusive language

  • 6: Violent or terrorist content

  • 7: Other

demo_audiostring

URL of the demo audio.

base_respobject

Properties

status_codeinteger

Status code:

  • 0: Success

  • 1000: Unknown error

  • 1001: Timeout

  • 1002: Rate limit exceeded

  • 1004: Authentication failed

  • 1013: Internal server error

  • 2013: Invalid input format

  • 2038: Insufficient permissions for voice cloning. Check your account authentication status.

status_msgstring

A description of the status.

usage object

Character usage for this request.

Properties

characters integer

The number of characters in the input text.

Query voice list

Important

MiniMax doesn't support this operation.

Request body

This example uses the Beijing region endpoint. For the Singapore region, use: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization.

Replace {WorkspaceId} with your actual workspace ID.

Qwen-Audio-TTS/CosyVoice

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "list_voice",
        "prefix": "myvoice",
        "page_size": 10,
        "page_index": 0
    }
}'

Qwen-TTS voice cloning

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-voice-enrollment",
    "input": {
        "action": "list",
        "page_size": 10,
        "page_index": 0
    }
}'

model string (required)

The voice cloning model. Valid values:

  • voice-enrollment: Qwen-Audio-TTS/CosyVoice voice cloning.

  • qwen-voice-enrollment: Qwen-TTS voice cloning.

input object (required)

The input parameters.

Properties

action string (required)

The action type. Qwen-Audio-TTS/CosyVoice: list_voice. Qwen: list.

prefix string (optional)

Important

Applies only to Qwen-Audio-TTS/CosyVoice.

Filters voices by name prefix.

page_index integer (optional)

The page index.

page_size integer (optional)

The number of entries per page.

Response body

Qwen-Audio-TTS/CosyVoice

{
    "output": {
        "voice_list": [
            {
                "voice_id": "qwen-audio-3.0-tts-plus-myvoice-xxxxxx",
                "gmt_create": "2024-12-11 13:38:02",
                "gmt_modified": "2024-12-11 13:38:02",
                "status": "OK"
            }
        ]
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

Qwen

{
    "output": {
        "page_index": 0,
        "page_size": 10,
        "total_count": 2,
        "voice_list": [
            {
                "voice": "yourVoice1",
                "gmt_create": "2025-08-11 17:59:32",
                "gmt_modified": "2025-08-11 17:59:32",
                "language": "en",
                "target_model": "qwen3-tts-vc-realtime-2026-01-15"
            }
        ]
    },
    "usage": {
        "count": 0
    },
    "request_id": "xxxx-xxxx-xxxx"
}
Important

Qwen-Audio-TTS/CosyVoice returns a voice_list array where each entry contains the voice_id field. Qwen also returns a voice_list array, but each entry contains the voice field instead. The Qwen output additionally includes the page_index, page_size, and total_count pagination fields.

request_id string

The unique identifier of this request.

output object

The data returned by the model.

Properties

page_index integer

Important

Returned only by Qwen.

The current page index.

page_size integer

Important

Returned only by Qwen.

The number of entries per page.

total_count integer

Important

Returned only by Qwen.

The total number of voices.

voice_list array[object]

The list of queried voices. Both Qwen-Audio-TTS/CosyVoice and Qwen use the voice_list field name.

Properties

voice_id / voice string

The voice ID. Qwen-Audio-TTS/CosyVoice uses voice_id, while Qwen uses voice.

gmt_create string

The creation time.

gmt_modified string

The last modification time.

status string

Important

Returned only by Qwen-Audio-TTS/CosyVoice.

The voice status. For valid values, see "Voice status descriptions".

target_model string

Important

Returned only by Qwen.

The TTS model that drives the cloned voice.

usage object

Usage information for this request.

Properties

count integer

Always 1 for Qwen-Audio-TTS/CosyVoice. Always 0 for Qwen.

Query voice details

Important

Applies only to Qwen-Audio-TTS/CosyVoice (when model is voice-enrollment). Qwen and MiniMax models don't support the query voice details operation.

Request body

This example uses the Beijing region endpoint. For the Singapore region, use: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization.

Replace {WorkspaceId} with your actual workspace ID.

Qwen-Audio-TTS/CosyVoice

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "query_voice",
        "voice_id": "yourVoiceId"
    }
}'

model string (required)

Set to voice-enrollment (Qwen-Audio-TTS/CosyVoice).

input object (required)

The input parameters.

Properties

action string (required)

Set to query_voice.

voice_id string (required)

The voice ID to query.

Response body

{
    "output": {
        "gmt_create": "2024-12-11 13:38:02",
        "resource_link": "https://yourAudioFileUrl",
        "target_model": "qwen-audio-3.0-tts-plus",
        "gmt_modified": "2024-12-11 13:38:02",
        "status": "OK"
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

request_id string

The unique identifier of this request.

output object

The data returned by the model.

Properties

resource_link string

The URL of the audio file.

gmt_create string

The creation time.

gmt_modified string

The last modification time.

status string

The voice status. For valid values, see "Voice status descriptions".

target_model string

The TTS model that drives the cloned voice.

usage object

Usage information for this request.

Properties

count integer

Always 1.

Update a voice

Important

Applies only to Qwen-Audio-TTS/CosyVoice voice cloning (when model is voice-enrollment). Qwen and MiniMax models don't support the update operation.

Request body

This example uses the Beijing region endpoint. For the Singapore region, use: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization.

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
                    
Replace {WorkspaceId} with your actual workspace ID. -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "voice-enrollment", "input": { "action": "update_voice", "voice_id": "yourVoiceId", "url": "https://new-audio-url.wav" } }'

model string (required)

Set to voice-enrollment.

input object (required)

The input parameters.

Properties

action string (required)

Set to update_voice.

voice_id string (required)

The voice ID to update.

url string (required)

The URL of the new audio file. The URL must be publicly accessible.

Response body

{
    "output": {},
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

request_id string

The unique identifier of this request.

output object

The data returned by the model. The update operation returns an empty object.

usage object

Usage information for this request.

Properties

count integer

Always 1.

Delete a voice

Important

MiniMax doesn't support this operation.

Request body

This example uses the Beijing region endpoint. For the Singapore region, use: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization.

Replace {WorkspaceId} with your actual workspace ID.

Qwen-Audio-TTS/CosyVoice

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "delete_voice",
        "voice_id": "yourVoiceId"
    }
}'

Qwen-TTS voice cloning

curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-voice-enrollment",
    "input": {
        "action": "delete",
        "voice": "yourVoice"
    }
}'

model string (required)

The voice cloning model. Valid values:

  • voice-enrollment: Qwen-Audio-TTS/CosyVoice voice cloning.

  • qwen-voice-enrollment: Qwen-TTS voice cloning.

input object (required)

The input parameters.

Properties

action string (required)

The action type. Qwen-Audio-TTS/CosyVoice: delete_voice. Qwen: delete.

voice_id string (conditionally required)

Important

Applies only to Qwen-Audio-TTS/CosyVoice.

The voice ID to delete.

voice string (conditionally required)

Important

Applies only to Qwen.

The voice name to delete.

Response body

Qwen-Audio-TTS/CosyVoice

{
    "output": {},
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

Qwen

{
    "output": {
        "voice": "yourVoice"
    },
    "usage": {
        "count": 0
    },
    "request_id": "xxxx-xxxx-xxxx"
}
Important

Qwen-Audio-TTS/CosyVoice returns an empty output object, while Qwen returns the voice field with the deleted voice name.

request_id string

The unique identifier of this request.

output object

The data returned by the model. Qwen-Audio-TTS/CosyVoice returns an empty object, while Qwen returns the name of the deleted voice.

Properties

voice string

Important

Returned only by Qwen.

The name of the deleted voice.

usage object

Usage information for this request.

Properties

count integer

Always 1 for Qwen-Audio-TTS/CosyVoice. Always 0 for Qwen.

Voice status descriptions

After a voice is created, it goes through a review process. The statuses below apply only to Qwen-Audio-TTS/CosyVoice (when model is voice-enrollment). Qwen query and list responses don't include a status field.

Status

Description

DEPLOYING

Under review or processing.

OK

Review passed. The voice is ready to use.

UNDEPLOYED

Review rejected. The voice can't be used.