跳转到主要内容
Send a GET request to https://api.qhaigc.net/v1/audio/voices to retrieve every voice character available to your account. The response includes all built-in system voices as well as any custom voices you have created through the Voice Clone API. Use the name field from each result as the voice parameter in POST /v1/audio/speech.

Request

GET https://api.qhaigc.net/v1/audio/voices
No request body is required. Include your API key in the Authorization header.

Built-in voice characters

The qhai-tts model includes 38+ built-in characters. A selection of available voices:
NameDescription
可爱少女Energetic and cute girl
御姐Mature and composed woman
派蒙Paimon (Genshin Impact)
温迪Venti (Genshin Impact)
纳西妲Nahida (Genshin Impact)
Call this endpoint to get the complete, up-to-date list of all available characters.

Response

success
boolean
true when the request succeeds.
voice_characters
array
Array of voice character objects.
total
integer
Total number of voice characters available to your account.

Example response

{
  "success": true,
  "voice_characters": [
    {
      "name": "可爱少女",
      "public": "public",
      "description": "元气可爱的少女声音"
    },
    {
      "name": "御姐",
      "public": "public",
      "description": "成熟稳重的女性声音"
    }
  ],
  "total": 38
}

Code examples

import requests

url = "https://api.qhaigc.net/v1/voice/models/list"
headers = {
    "Authorization": "Bearer sk-your-api-key-here"
}

response = requests.get(url, headers=headers)
data = response.json()

for character in data["voice_characters"]:
    print(character["name"], "-", character["description"])