跳转到主要内容
POST
/
openapi
/
v1
/
assets
/
voice
/
basic
/
list
系统音色列表
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.

授权

Authorization
string
header
必填

Authorization 请求头中传入 API Key(Bearer <api_key>)。见 鉴权

请求体

application/json
voiceId
string

按系统预设 voiceId 筛选。见 音色

searchName
string

按展示名或本地化名称搜索

locale
string

按 locale(BCP-47)筛选。见 支持的语言

示例:

"en-US"

age
string

young / adult / senior

gender
string

按性别筛选

quality
string

any / high

category
string

按音色分类筛选

emotionPrompt
string

exclude / include

topIds
string[]

将这些系统预设 voiceId 置顶。见 音色

currentPage
integer
默认值:1

页码(从 1 开始)

pageSize
integer
默认值:10

每页条数

orderBy
string

voiceId / score / create_time / update_time / is_preferred

order
string
默认值:desc

排序方向:ascdesc

响应

200 - application/json

成功

code
integer
必填

业务码;200 表示成功

示例:

200

message
string

code 非成功时的说明信息

示例:

""

data
object