CosyVoice

Query a cloned voice

POST

/services/audio/tts/customization

cURL

curl -X POST https://dashscope-intl.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": "cosyvoice-v3-plus-myvoice-xxxxxx"
  }
}'

{
  "output": {
    "gmt_create": "2024-12-11 13:38:02",
    "gmt_modified": "2024-12-11 13:38:02",
    "resource_link": "https://yourAudioFileUrl",
    "target_model": "cosyvoice-v3-plus",
    "status": "OK"
  },
  "usage": {
    "count": 1
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Authorizations

string

header

required

DashScope API key. Get one at API key.

Body

application/json

enum<string>

required

Fixed to voice-enrollment.

Available options:voice-enrollment

Example:voice-enrollment

object

required

Show child attributes

enum<string>

required

Fixed to query_voice.

Available options:query_voice

Example:query_voice

string

required

The voice ID to query.

Example:cosyvoice-v3-plus-myvoice-xxxxxx

Response

200-application/json

object

Show child attributes

string

Voice creation timestamp.

Example:2024-12-11 13:38:02

string

Last modification timestamp.

Example:2024-12-11 13:38:02

string

URL of the original audio file used for cloning.

Example:https://yourAudioFileUrl

string

Speech synthesis model bound to this voice.

Example:cosyvoice-v3-plus

enum<string>

Voice status: DEPLOYING (under review), OK (approved, usable), or UNDEPLOYED (not approved).

Available options:DEPLOYING,OK,UNDEPLOYED

Example:OK

object

Show child attributes

integer

Fixed as 1.

Example:1

string

Request ID for troubleshooting.

Example:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

cURL

curl -X POST https://dashscope-intl.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": "cosyvoice-v3-plus-myvoice-xxxxxx"
  }
}'

{
  "output": {
    "gmt_create": "2024-12-11 13:38:02",
    "gmt_modified": "2024-12-11 13:38:02",
    "resource_link": "https://yourAudioFileUrl",
    "target_model": "cosyvoice-v3-plus",
    "status": "OK"
  },
  "usage": {
    "count": 1
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}