Text to Speech

Convert text to lifelike audio using OpenAI TTS and other voice models.

Endpoint

POST https://api.samuraiapi.in/v1/audio/speech

Parameters

Parameter	Type	Required	Description
model	string	✅	tts-1 or tts-1-hd
input	string	✅	Text to convert (max 4096 chars)
voice	string	✅	Voice preset (see below)
response_format	string	—	mp3 (default), opus, aac, flac, wav
speed	number	—	Speed: 0.25–4.0. Default: 1.0

Available Voices

Voice	Character
alloy	Neutral, versatile
echo	Male, authoritative
fable	British, storytelling
onyx	Deep, powerful
nova	Female, friendly
shimmer	Female, soft

Code Examples

Python

from openai import OpenAI
from pathlib import Path

client = OpenAI(
    api_key="sk-samurai-YOUR_KEY",
    base_url="https://api.samuraiapi.in/v1"
)

response = client.audio.speech.create(
    model="tts-1-hd",
    voice="nova",
    input="The way of the samurai is found in death. Meditation on inevitable death...",
    speed=0.9
)

response.stream_to_file(Path("output.mp3"))
print("Saved to output.mp3")

Models

Model	Quality	Latency	Price
tts-1	Standard	Lower	$7.50/1M chars
tts-1-hd	High fidelity	Higher	$15/1M chars

Samurai AI prices are 50% off. tts-1 is $3.75/1M characters.