New: AI video tools. Cut, clip, caption and dub your videos. See all video tools →
TTS

Generate speech from text

POST
/api/v1/tts/generate

Generate speech using a built-in speaker voice, with optional style instruction.

Query Parameters

sync?Sync

Wait for generation to complete and return audio directly

Defaultfalse

Request Body

application/json
  1. body
text*Text

Text to generate speech for

speaker*Speaker

Speaker ID (e.g. 'Ryan', 'Vivian')

language?Language

Target language. Query GET /api/v1/models/active for supported languages per variant.

Default"Auto"
instruct?|

Optional voice style instruction

quality?|

Quality/variant tier. Query GET /api/v1/models/active for available tiers.

generation_params?|

Advanced sampling parameters

model_family?|

TTS model to use. If omitted, uses the currently configured model.

Response Body

Generation started (async) or completed result (sync).

application/json
  1. response
started*Started

Whether the generation job was enqueued

queue_position*Queue Position

Position in the generation queue (0 = next to run)

Example Request
curl -X POST 'http://127.0.0.1:8100/api/v1/tts/generate' \  -H 'Content-Type: application/json' \  -d '{  "text": "Hello, how are you today?",  "speaker": "Vivian"}'
Example Response
{  "started": true,  "queue_position": 0}