Get Default Voice List

Fetches the default digital human voice list for selecting available voices when generating digital human videos.

---

Overview

• Method: GET
• Path: /avatar/voice
• Content-Type: application/json
• Category: Video Models (Video) / Digital Human

Authentication

• Header: Authorization: Bearer <token>

---

Request Parameters

Parameter	Type	Required	Description
language	string	No	Language filter, supports en, zh

---

Request Example

curl Example

curl -X GET "https://api.gpt.ge/avatar/voice?language=zh" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/avatar/voice?language=zh', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  }
})
  .then(res => res.json())
  .then(console.log)

Python (requests) Example

import requests

resp = requests.get(
    'https://api.gpt.ge/avatar/voice?language=zh',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)
print(resp.json())

---

Response Fields

Field	Type	Description
code	string	API return status
data	object	Response data object
data.audio_list	array	Voice list
data.audio_list[].audio_id	string	Voice ID
data.audio_list[].audio_url	string	Voice URL
data.audio_list[].labels	array[string]	Voice labels
data.audio_list[].language	string	Language
data.audio_list[].name	string	Voice name
data.audio_list[].vip_enable	boolean	VIP enabled flag
data.audio_list[].voice_engine_id	string	Voice engine ID
data.audio_list[].type	string	Voice type
message	string	Return message

---

Response Example (200)

{
  "code": "success",
  "data": {
    "audio_list": [
      {
        "audio_id": "cffcff22110049a487aa4fa7a382e3dc",
        "audio_url": "server/ranker/main/d5f86550f71f4b968e1bd431364fffb9.wav",
        "labels": ["Female"],
        "language": "zh",
        "name": "Yue Hua",
        "vip_enable": false,
        "voice_engine_id": "yuexiaohua"
      },
      {
        "audio_id": "e5d50afcd63446129bfc547635c9ccf9",
        "audio_url": "https://s3.amazonaws.com/pt-tts-new/oneshot_tts_result/20241212/_/4802465.wav",
        "labels": ["Male"],
        "language": "zh",
        "name": "Santa Claus-B",
        "type": "small",
        "vip_enable": false,
        "voice_engine_id": "x1_santa_claus_1"
      }
    ]
  },
  "message": ""
}