Lightning v3.1

Generate speech from text (Lightning V3.1)

curl --request POST \
  --url https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "voice_id": "<string>",
  "sample_rate": 44100,
  "speed": 1,
  "language": "auto",
  "output_format": "pcm",
  "pronunciation_dicts": [
    "<string>"
  ]
}
'

import requests

url = "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech"

payload = {
    "text": "<string>",
    "voice_id": "<string>",
    "sample_rate": 44100,
    "speed": 1,
    "language": "auto",
    "output_format": "pcm",
    "pronunciation_dicts": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    text: '<string>',
    voice_id: '<string>',
    sample_rate: 44100,
    speed: 1,
    language: 'auto',
    output_format: 'pcm',
    pronunciation_dicts: ['<string>']
  })
};

fetch('https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'text' => '<string>',
    'voice_id' => '<string>',
    'sample_rate' => 44100,
    'speed' => 1,
    'language' => 'auto',
    'output_format' => 'pcm',
    'pronunciation_dicts' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech"

	payload := strings.NewReader("{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

"<string>"

{
  "error": "InvalidRequest",
  "message": "The 'text' field is required."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred."
}

POST

waves

lightning-v3.1

get_speech

Generate speech from text (Lightning V3.1)

curl --request POST \
  --url https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "voice_id": "<string>",
  "sample_rate": 44100,
  "speed": 1,
  "language": "auto",
  "output_format": "pcm",
  "pronunciation_dicts": [
    "<string>"
  ]
}
'

import requests

url = "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech"

payload = {
    "text": "<string>",
    "voice_id": "<string>",
    "sample_rate": 44100,
    "speed": 1,
    "language": "auto",
    "output_format": "pcm",
    "pronunciation_dicts": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    text: '<string>',
    voice_id: '<string>',
    sample_rate: 44100,
    speed: 1,
    language: 'auto',
    output_format: 'pcm',
    pronunciation_dicts: ['<string>']
  })
};

fetch('https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'text' => '<string>',
    'voice_id' => '<string>',
    'sample_rate' => 44100,
    'speed' => 1,
    'language' => 'auto',
    'output_format' => 'pcm',
    'pronunciation_dicts' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech"

	payload := strings.NewReader("{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smallest.ai/waves/v1/lightning-v3.1/get_speech")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"text\": \"<string>\",\n  \"voice_id\": \"<string>\",\n  \"sample_rate\": 44100,\n  \"speed\": 1,\n  \"language\": \"auto\",\n  \"output_format\": \"pcm\",\n  \"pronunciation_dicts\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

"<string>"

{
  "error": "InvalidRequest",
  "message": "The 'text' field is required."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred."
}

Overview

Lightning v3.1 is a 44 kHz text-to-speech model that delivers natural, expressive, and realistic speech synthesis.

Key Features

Voice Cloning Support: Compatible with cloned voices
Ultra-Low Latency: Optimized for real-time applications
Multi-Language: Supports English (en) and Hindi (hi)
Multiple Output Formats: PCM, MP3, WAV, and mulaw
Flexible Sample Rates: 8000 Hz to 44100 Hz
Speed Control: Adjustable from 0.5x to 2x speed

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <api_key>, where <api_key> is your api key.

Body

application/json

text

string

required

The text to convert to speech.

voice_id

string

required

The voice identifier to use for speech generation.

sample_rate

enum<integer>

default:44100

The sample rate for the generated audio.

Available options:

8000,

16000,

24000,

44100

speed

number

default:1

The speed of the generated speech.

Required range: 0.5 <= x <= 2

language

enum<string>

default:auto

Language code for text normalization (e.g., how numbers, dates, and abbreviations are spelled out). Set to 'auto' for automatic language detection, or specify a language code like 'en' or 'hi'.

Available options:

auto,

en,

hi,

ta,

es

output_format

enum<string>

default:pcm

The format of the output audio.

Available options:

pcm,

mp3,

wav,

mulaw

pronunciation_dicts

string[]

The IDs of the pronunciation dictionaries to use for speech generation.

The ID of the pronunciation dictionary to use for speech generation.

Response

Synthesized speech retrieved successfully.

A PCM int16 WAV file at the specified sample rate.

WebSocket Lightning v3.1 SSE

API References

Text to Speech

Speech to Text

Voices

Voice Cloning

Pronunciation Dictionaries

Lightning v3.1

Overview

Key Features

Authorizations

Body

Response

​Overview

​Key Features

Authorizations

Body

Response

Overview

Key Features