Get Voices | Smallest AI Docs

import requests
url = "https://api.smallest.ai/waves/v1/lightning-v3.1/get_voices"
payload = {}
headers = {
    "Authorization": "Bearer <BearerAuth>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "voices": [
    {
      "voiceId": "lightning_v3.1_en_us_male_01",
      "displayName": "Lightning US Male 01",
      "tags": {
        "language": [
          "english"
        ],
        "accent": "american",
        "gender": "male",
        "age": "middle-aged",
        "emotions": [
          "neutral",
          "happy",
          "sad"
        ],
        "usecases": [
          "conversational",
          "narration"
        ]
      }
    },
    {
      "voiceId": "lightning_v3.1_en_gb_female_02",
      "displayName": "Lightning UK Female 02",
      "tags": {
        "language": [
          "english"
        ],
        "accent": "british",
        "gender": "female",
        "age": "young",
        "emotions": [
          "neutral",
          "excited"
        ],
        "usecases": [
          "audiobook",
          "customer-support"
        ]
      }
    },
    {
      "voiceId": "lightning_v3.1_hi_in_female_01",
      "displayName": "Lightning Hindi Female 01",
      "tags": {
        "language": [
          "hindi"
        ],
        "accent": "indian",
        "gender": "female",
        "age": "middle-aged",
        "emotions": [
          "neutral",
          "calm"
        ],
        "usecases": [
          "conversational",
          "education"
        ]
      }
    }
  ]
}

List voices available for Lightning v3.1. The response is the union of the standard and Pro voice catalogs — the API does not return a per-voice “is Pro” flag, so consult the Lightning v3.1 Pro and Lightning v3.1 model cards for the canonical per-pool voice lists. Use the voice_id from this response together with "model": "lightning_v3.1" (default) or "model": "lightning_v3.1_pro" on the unified /waves/v1/tts route to pick the pool.

List voices available for Lightning v3.1. The response is the union of the standard and Pro voice catalogs — the API does not return a per-voice "is Pro" flag, so consult the [Lightning v3.1 Pro](/waves/model-cards/text-to-speech/lightning-v-3-1-pro) and [Lightning v3.1](/waves/model-cards/text-to-speech/lightning-v-3-1) model cards for the canonical per-pool voice lists. Use the `voice_id` from this response together with `"model": "lightning_v3.1"` (default) or `"model": "lightning_v3.1_pro"` on the unified `/waves/v1/tts` route to pick the pool.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Path parameters

modelenumRequiredDefaults to lightning-v3.1

The catalog to query. Currently only lightning-v3.1 is supported — the response returns the union of standard Lightning v3.1 voices and Lightning v3.1 Pro voices. The API does not include a per-voice Pro flag; consult the model cards for the canonical per-pool catalogs.

Allowed values:

Response

Voices retrieved successfully.

voiceslist of objects

List of available voices.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error