Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Create narration, ad reads and spoken translations as downloadable MP3 or WAV files.
generate_speech to turn your script into audio. Charges use your Developer Balance.
Use NinjaChat to create a voiceover for this script:
"A little less ordinary. A little more you. Meet your new everyday."
Use Onyx and return an MP3. Quote the exact script with TTS HD
and wait for approval before generating.
| Model | Price per 1,000 characters |
|---|---|
tts-1 | $0.015 |
tts-1-hd (default) | $0.030 |
alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer. Default: nova.
estimate_cost:
{
"tool": "generate_speech",
"model": "tts-1-hd",
"input": "A little less ordinary. A little more you."
}
generate_speech:
{
"model": "tts-1-hd",
"input": "A little less ordinary. A little more you.",
"voice": "onyx",
"response_format": "mp3",
"speed": 1,
"max_spend_cents": 1,
"idempotency_key": "campaign-voiceover-001"
}
| Parameter | Accepted values |
|---|---|
input | Required, literal script; 1–4,096 characters. |
model | tts-1 or tts-1-hd. |
voice | One of the nine voices above. |
response_format | mp3 (default) or wav. |
speed | 0.25–4; default 1. |
max_spend_cents | Optional ceiling, greater than 0 and at most 100; fractional cents accepted. |
idempotency_key | Required, 1–128 characters. Reuse for the same retry; use a new value for each new recording. |
search_creations(kind: "audio") or get_creation.