List Voices

Query the voices available to the current tenant. Voices are uniformly identified by a voice id, referenced by endpoints such as Single-speaker Speech.

GET

/v1/audio/voices

List the voices available to the current tenant. Returns a list object; for security boundaries, voice URLs are not returned.

Preview voices

15 voices

Browse more voices in the Mossland voice library.

Voice name	Voice ID	Description	Language
Mambo (Accented)	`c6c0a40a-ea82-4468-9a21-333d3c4a76f6`	Anime, Character Dubbing · Brisk, Cute, Funny	Chinese · Mandarin
Ming Taizu (Hongwu Emperor)	`f80b6698-0066-430b-88a0-f0fb8796db34`	Character Dubbing, Film & TV · Aloof, Calm, Domineering CEO	Chinese · Mandarin
VOX AKUMA	`ddc6e38b-6f55-4415-b21b-a88cad2cc1d9`	Podcast, Social Media · Lazy, Magnetic, Professional	English · British English
Li Bai	`7662a8a1-700c-466a-b66b-57ece9e2e231`	Film & TV, People · Ancient Style, Passionate	Chinese · Mandarin
Jake (Narrator)	`f9a1416b-d006-4b77-9581-8f0e8ec1e401`	Character Dubbing, People · Calm, Magnetic, Professional	English · British English
Experienced Female Teacher	`faf7f550-0627-4fc6-8db0-d3bfdad49358`	Education, Social Media · Aloof, Natural	Chinese · Mandarin
Youthful Male Voice	`fe85a513-9bf3-4ef7-aa0b-8b2d11e4db93`	Audiobook, Narration · Gentle, Magnetic, Natural	Chinese · Mandarin
Male History Narrator	`0804710c-8e5e-4b67-acda-5785ef13c309`	Audiobook, Film & TV Commentary · Calm, Magnetic	Chinese · Mandarin
Elegant British Lady	`9d1e88e9-3b9c-4992-a414-7a1cb3ff7ab5`	Film & TV, People · Gentle, Magnetic, Natural	English · British English
Bright & Lively Female Voice	`806c9695-6160-404e-8722-4f788d935af3`	Customer Service, Trending Play · Brisk, Lively, Natural	Chinese · Mandarin
Classical Chinese Poetry Recitation	`2fdf194e-c16e-4587-9027-0d3464e09b4e`	Education, Narration · Calm, Magnetic, Professional	Chinese · Mandarin
Forbidden City Documentary	`133bd03b-d717-4a55-8974-7ffc9afc1b51`	Documentary, Narration · Calm, Magnetic, Professional	Chinese · Mandarin
Brother Hu (Northeast China)	`26838557-6890-4505-bc7c-e8198443a141`	Entertainment, Social Media · Funny, Lazy	Chinese · Mandarin
Melancholy Autumn	`19411508-8731-4b68-901d-7e4b8a98e23f`	Film & TV, People · Gentle, Lazy	Chinese · Mandarin
Agriculture & Rural Affairs Narrator	`944eb93b-3820-49f3-b2c0-4e37a31d1161`	Documentary, Narration · Brisk, Magnetic, Professional	Chinese · Mandarin

Authentication

Add Authorization: Bearer <API_KEY> to the request headers to authenticate. You can generate a key on the console "API Keys" page.

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

Request fields

Query	Type	Required	Description
limit	integer	No	Number of results to return; defaults to 20, with a maximum of 150.
offset	integer	No	Offset.
after	string	No	Pagination cursor; use the `next_cursor` returned by the previous page.
status	string	No	Filter by voice status; the exact allowed values are subject to the server.

Request example

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

Response fields

Field	Type	Always returned	Description
object	string	Yes	Fixed as `list`.
data[].id	string	Yes	voice id; referenced by the TTS/TTSD/voice-generation endpoints.
data[].object	string	Yes	Fixed as `audio.voice`.
data[].name	string	Yes	Human-readable name; may be an empty string.
data[].created_at	integer	Yes	Creation time, a Unix timestamp in seconds.
has_more	boolean	Yes	Whether there are more voices.
first_id	string	When data is non-empty	The first voice id on the current page.
last_id	string	When data is non-empty	The last voice id on the current page.
next_cursor	string	When there is a next page	Cursor for the next page; can be passed as `after` in the next request.

Response example

{
  "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
}

Next steps

Create Voice

Create or clone a voice from a multipart audio sample.

Single-speaker Speech

Text-to-speech endpoint.