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

Generate from saved design voice

POST
/api/v1/generation/design/saved

Generate speech using a previously saved voice design. Validates voice_id exists on disk.

Query Parameters

sync?Sync

Wait for generation to complete and return audio directly

Defaultfalse

Request Body

application/json
  1. body
voice_id*Voice Id

ID of the saved voice design

target_text*Target Text

Text to generate speech for

language?Language

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

Default"Auto"
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/generation/design/saved' \  -H 'Content-Type: application/json' \  -d '{  "voice_id": "a1b2c3d4",  "target_text": "This is a test of the saved voice."}'
Example Response
{  "started": true,  "queue_position": 0}