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

Load TTS model

POST
/api/v1/model/load

Load or switch the TTS model.

A model must be loaded before any generation endpoint will work. If the requested mode/quality is already loaded, returns immediately with status: "already_loaded". Otherwise begins async loading — poll GET /api/v1/model/load/progress until status: "complete".

Switching generation mode (clone / design / tts) requires a different model variant and triggers a reload.

Query Parameters

sync?Sync

Wait for loading to complete

Defaultfalse

Request Body

application/json
  1. body
Default{}
mode?|

Generation mode to load (clone, design, tts). Uses current if omitted.

quality?|

Quality preset to load. Uses current if omitted.

Response Body

Successful Response

application/json
  1. response
status*Status

Load status (loading, complete, already_loaded, error)

mode?|

Generation mode being loaded

quality?|

Quality preset being loaded

message?|

Error message if status is 'error'

Example Request
curl -X POST 'http://127.0.0.1:8100/api/v1/model/load' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "status": "loading",  "mode": "clone",  "quality": "higher_quality",  "message": "string"}