查询音色列表

试听音色

更多音色请到 Mossland 音色库查看。

查询参数

Query类型必填说明

limit: integer可选

返回数量，默认 20，最大 150。

offset: integer可选

偏移量。

after: string可选

分页游标，取上一页返回的 next_cursor。

status: string可选

按音色状态过滤；具体可用值以服务端为准。

返回值

字段类型说明

object: string

固定为 list。

data: array

音色列表；无可用音色时为空数组。

has_more: boolean

是否还有更多音色。

first_id: string

data 非空时返回当前页首个 voice id。

last_id: string

data 非空时返回当前页末个 voice id。

next_cursor: string

有下一页时返回游标；下一次请求可作为 after 传入。

下一步

创建音色

通过 multipart 音频样本创建或克隆音色。

单人语音生成

文本转语音接口。

请求示例

curl -X GET "https://api.mosi.cn/v1/audio/voices?limit=20" \
  -H "Authorization: Bearer $MOSS_API_KEY"

import os
import requests

response = requests.get(
        "https://api.mosi.cn/v1/audio/voices?limit=20",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/audio/voices?limit=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
  },
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "<voice_id>",
      "object": "audio.voice",
      "name": "Alice",
      "created_at": 1710000000
    }
  ],
  "first_id": "<voice_id>",
  "last_id": "<voice_id>",
  "has_more": true,
  "next_cursor": "b2Zmc2V0OjIw"
}