Create speech
Send JSON to POST https://api.teenage.works/v1/audio/speech.
{
"model": "teen-v1",
"input": "Build a clear spoken response.",
"language": "en",
"response_format": "mp3",
"stream": false
}Input and voice fields
| Field | Default | Accepted value |
|---|---|---|
input | Required | Plain text from 1 to 4096 characters |
model | teen-v1 | teen-v1 |
language | hi | A supported language code or regional form |
voice | default | default or a public or saved voice_... ID |
transliterate | false | true converts Romanized Hindi words to Devanagari before synthesis |
Inline performance tags such as [happy], [pause], and [whisper] are rejected with unsupported_tags.
Choose one voice path
Use voice for a saved or public voice, or send both reference fields for a one-request zero-shot clone:
| Path | Fields |
|---|---|
| Voice ID | voice |
| Clone | reference_audio (base64, up to 6 MB) and reference_audio_format (wav, mp3, flac, or ogg) |
Voice ID
{
"input": "Welcome to the show.",
"language": "en",
"voice": "default",
"response_format": "mp3",
"stream": false
}Reference clone
{
"input": "Use the supplied speaker identity.",
"language": "en",
"reference_audio": "<BASE64_REFERENCE_AUDIO>",
"reference_audio_format": "wav",
"response_format": "mp3",
"stream": false
}Reference fields must be supplied together. Combining a saved voice ID and reference audio, or sending voice descriptions or reference transcripts, returns HTTP 422.
Delivery fields
| Field | Default | Accepted value |
|---|---|---|
response_format | pcm | pcm, mp3, or wav |
output_sample_rate | Model sample rate | Integer from 8000 through 48000 |
stream | true | true or false |
stream_format | audio | audio or sse when streaming |
WAV is buffered. If stream is omitted, requesting WAV selects buffered delivery; explicitly combining WAV with stream: true returns 422.
Generation fields
| Field | Default | Accepted value |
|---|---|---|
quality | fast | fast or expressive |
cfg_value | 2.0 | Number from 1.0 through 3.0 |
temperature | 1.0 | Number greater than 0 through 2.0 |
max_generate_length | 2000 | Integer from 32 through 4096 |
lora | null | Registered server-side LoRA name, up to 128 characters |
When quality is expressive, omitted temperature and cfg_value fields use the expressive profile. Explicit values take precedence. The server controls the seed; requests that set it return 422. Unknown fields return 422.