MUmunsit
Voices

Get Voices

Changed on

Retrieve a list of all available voices for text-to-speech synthesis

get/voices

Request

  • Base URL
    https://api.munsit.com/api/v1
  • URL
    https://api.munsit.com/api/v1/voices
  • Auth
    API key in header x-api-key

Query parameters

tagsstring

Comma-separated use-case tags. A voice matches when it carries at least one of them. Allowed values: conversational, narration, characters, social_media, educational, advertisement, documentary, news_broadcast. Unknown values return 400.

dialectstring

Comma-separated dialect ids (e.g., emirati, saudi, fusha). A voice matches when it carries at least one. saudi also matches najdi, hijazi and southern_saudi. Unknown values return 400.

Response

List of available voices

voice_idstring required

Unique identifier for the voice (used in text-to-speech requests)

namestring required

Human-readable name of the voice

descriptionstring nullable

Detailed description of the voice characteristics

gender'male' | 'female' nullable

Gender of the voice

age'middle' | 'elderly' nullable

Age category of the voice

languagesstring[] required

List of language codes supported by the voice (e.g., ["ar", "en"])

dialectstring[] required

List of dialects supported by the voice (e.g., ["fusha", "emirati", "najdi"])

tagsstring[] nullable

Use cases the voice is curated for, as shown in the dashboard filters (e.g., ["conversational"]). null when the voice has not been tagged.

type'neural' nullable

Voice type

sample_urlstring uri required

URL to an audio sample of the voice

is_clonedboolean required

true for a voice your account created with voice cloning, false for a Munsit catalogue voice

Changes

  • d26f3860be0dRevision changes
    • breaking

      the response's property type changed from string to integer for status

    • breaking

      the response's property type changed from string to integer for status

    • info

      added the new optional query request parameter dialect

    • info

      added the new optional query request parameter tags

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status