Query Available Voice IDs

Skill Document Pricing Token Plan Releases

Query voice information under different categories, and get all voice IDs (voice_id) available for the current account, including system voices and voices generated by fast cloning.

POST/v1/audio/voices/query

Authorization

AuthorizationstringheaderRequired

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，Used to verify account information, can be viewed in Metered & Packs > API Key Management .

Request Header

Content-Typeenum<string>Default: application/jsonRequired

Request Body application/json

voice_typeenum<string>Required

Type of voice to query:

system：System predefined voice
voice_cloning：Fast cloned voice
voice_design：Designed voice
all：All types of voices

Response Body Structure

system_voicearray<object>

Array of system-predefined voice data, returns an empty array if no matching data

system_voice[i].voice_idstring

Unique identifier ID of the system voice

system_voice[i].descriptionarray<string>

Description information of the voice, including style, applicable scenarios, etc.

system_voice[i].voice_namestring

Chinese name of the voice

system_voice[i].languagearray<string>

Language of the voice

system_voice[i].dialectarray<string>

Dialects of the voice

voice_cloningarray<object>

Array of fast cloned voice data, returns an empty array if no matching data

voice_cloning[i].voice_idstring

Unique identifier ID of the fast cloned voice

voice_cloning[i].created_timestring

Creation time of the cloned voice

voice_designarray<object>

Array of designed voice data, returns an empty array if no matching data

voice_design[i].voice_idstring

Unique identifier ID of the designed voice

voice_design[i].descriptionarray<string>

Voice description (prompt) of the designed voice

voice_design[i].created_timestring

Creation time of the designed voice

base_respobject

Basic status information of this request

base_resp.status_codeinteger

Request status code, 0 indicates successful request

base_resp.status_msgstring

Request status description, success indicates successful request

Get Voices

curl --request POST \
  --url https://maas-api.unisound.com/v1/audio/voices/query \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "voice_type": "all"
  }'

200

{
  "system_voice": [
    {
      "voice_id": "cn_male_chenyu",
      "description": [
        "清朗明快"
      ],
      "voice_name": "晨宇",
      "language": [
        "zh"
      ],
      "dialect": [
        "sichuan",
        "yueyu"
      ],
      "created_time": "1970-01-01"
    }
  ],
  "voice_cloning": [
    {
      "voice_id": "my-voice-001",
      "description": [],
      "created_time": "2026-03-20"
    }
  ],
  "voice_design": [
    {
      "voice_id": "my-design-001",
      "description": [
        "沉稳的中年男性声音，语速适中"
      ],
      "created_time": "2026-03-20"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}