查询音色列表

查询当前租户可用音色。音色统一以 voice id 标识，供单人语音生成等接口引用。

GET

/v1/audio/voices

列出当前租户可用音色。返回 list 对象；出于安全边界，不返回音色 URL。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。

curl https://api.mosi.cn/v1/audio/voices \
  -H "Authorization: Bearer $MOSS_API_KEY"

请求字段

Query	类型	必填	说明
limit	integer	否	返回数量，默认 20。
offset	integer	否	偏移量。
after	string	否	分页游标，取上一页返回的 `next_cursor`。
status	string	否	按音色状态过滤；具体可用值以服务端为准。

请求示例

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

响应字段

字段	类型	必返	说明
object	string	是	固定为 `list`。
data[].id	string	是	voice id；TTS/TTSD/音色生成接口引用该值。
data[].object	string	是	固定为 `audio.voice`。
data[].name	string	是	用户可读名称；可能为空字符串。
data[].created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
has_more	boolean	是	是否还有更多音色。
first_id	string	data 非空时	当前页首个 voice id。
last_id	string	data 非空时	当前页末个 voice id。
next_cursor	string	有下一页时	下一页游标；下一次请求可作为 `after` 传入。

响应示例

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

下一步

创建音色

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

单人语音生成

文本转语音接口。