Skip to main content
POST
/
openapi
/
v1
/
assets
/
voice
/
basic
/
list
List system voices
curl --request POST \
  --url https://api.vmeg.ai/openapi/v1/assets/voice/basic/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voiceId": "<string>",
  "searchName": "<string>",
  "locale": "en-US",
  "age": "<string>",
  "gender": "<string>",
  "quality": "<string>",
  "category": "<string>",
  "emotionPrompt": "<string>",
  "topIds": [
    "<string>"
  ],
  "currentPage": 1,
  "pageSize": 10,
  "orderBy": "<string>",
  "order": "desc"
}
'
{
  "code": 200,
  "message": "",
  "data": {
    "records": [
      {
        "voiceId": "<string>",
        "name": "<string>",
        "localName": "<string>",
        "displayName": "<string>",
        "locale": "en-US",
        "localeName": "<string>",
        "provider": "<string>",
        "gender": "<string>",
        "style": "<string>",
        "rolePlay": "<string>",
        "description": "<string>",
        "personalities": "<string>",
        "personalityList": [
          "<string>"
        ],
        "scenarios": "<string>",
        "scenarioList": [
          "<string>"
        ],
        "isHd": 123,
        "isPreferred": 123,
        "score": 123,
        "model": "<string>",
        "cover": "<string>",
        "audio": "<string>",
        "createTime": "<string>",
        "updateTime": "<string>"
      }
    ],
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vmeg.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Send your API Key in the Authorization header (Bearer <api_key>). See Authentication.

Body

application/json
voiceId
string

Filter by preset voiceId. See Voices

searchName
string

Search by display or local name

locale
string

Filter by locale (BCP-47). See Supported languages

Example:

"en-US"

age
string

young / adult / senior

gender
string

Filter by gender

quality
string

any / high

category
string

Filter by voice category

emotionPrompt
string

exclude / include

topIds
string[]

Pin these preset voiceId values to the top. See Voices

currentPage
integer
default:1

Page number (1-based)

pageSize
integer
default:10

Page size

orderBy
string

voiceId / score / create_time / update_time / is_preferred

order
string
default:desc

Sort direction: asc or desc

Response

200 - application/json

Success

code
integer
required

Business code; 200 means success

Example:

200

message
string

Human-readable detail when code is not success

Example:

""

data
object