usamaehsan/ltx-voice-one
LTX voice: text to speech with voice design or a saved voice_id, one warm pool (merged ltx-voice + lock).
Public
257
runs
Run usamaehsan/ltx-voice-one with an API
Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.
Input schema
The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.
| Field | Type | Default value | Description |
|---|---|---|---|
| prompt |
string
|
Describe the speaker, the emotion and the room, and put the exact words in quotes, e.g. A tired old man says softly: "I waited all night for you." Quiet room, no music.
|
|
| voice_id |
string
|
|
Optional id of a voice from our voice library (designed voices made by this model). The new words continue in that voice. Empty = a new voice from the prompt.
|
| duration |
number
|
0
Max: 20 |
Seconds of audio, rounded up to the next 0.5 s. 0 = let the model pick from the prompt.
|
| seed |
integer
|
-1
|
Random seed. -1 = random.
|
| steps |
None
|
8
|
Denoising steps from the distilled schedule (8 = full quality).
|
| refine |
boolean
|
False
|
Extra 3-step refine pass (like stage 2 of the video model).
|
| ancestral |
boolean
|
True
|
Ancestral sampler (what LTX-2.5 uses).
|
| output_format |
None
|
mp3
|
Audio format (mp3 = mono 96 kbps, wav = stereo 16-bit).
|
| trim_text |
boolean
|
True
|
Run the text encoder on the real prompt tokens only (fast).
|
| profile |
boolean
|
False
|
Debug: also print a torch profiler table and the text-trim check to the logs. Output is audio as usual.
|
| reference_audio |
string
|
Internal only (needs clone_key): a 1.5-8.5 s clean speech clip whose voice the new words continue in.
|
|
| reference_text |
string
|
|
Internal only: the exact words spoken in reference_audio.
|
| clone_key |
string
|
|
Internal only: our team's key for reference_audio. Public calls leave it empty.
|
{
"type": "object",
"title": "Input",
"required": [
"prompt"
],
"properties": {
"seed": {
"type": "integer",
"title": "Seed",
"default": -1,
"x-order": 3,
"description": "Random seed. -1 = random."
},
"steps": {
"enum": [
3,
4,
5,
6,
8
],
"type": "integer",
"title": "steps",
"description": "Denoising steps from the distilled schedule (8 = full quality).",
"default": 8,
"x-order": 4
},
"prompt": {
"type": "string",
"title": "Prompt",
"x-order": 0,
"description": "Describe the speaker, the emotion and the room, and put the exact words in quotes, e.g. A tired old man says softly: \"I waited all night for you.\" Quiet room, no music."
},
"refine": {
"type": "boolean",
"title": "Refine",
"default": false,
"x-order": 5,
"description": "Extra 3-step refine pass (like stage 2 of the video model)."
},
"profile": {
"type": "boolean",
"title": "Profile",
"default": false,
"x-order": 9,
"description": "Debug: also print a torch profiler table and the text-trim check to the logs. Output is audio as usual."
},
"duration": {
"type": "number",
"title": "Duration",
"default": 0,
"maximum": 20,
"minimum": 0,
"x-order": 2,
"description": "Seconds of audio, rounded up to the next 0.5 s. 0 = let the model pick from the prompt."
},
"voice_id": {
"type": "string",
"title": "Voice Id",
"default": "",
"x-order": 1,
"description": "Optional id of a voice from our voice library (designed voices made by this model). The new words continue in that voice. Empty = a new voice from the prompt."
},
"ancestral": {
"type": "boolean",
"title": "Ancestral",
"default": true,
"x-order": 6,
"description": "Ancestral sampler (what LTX-2.5 uses)."
},
"clone_key": {
"type": "string",
"title": "Clone Key",
"default": "",
"x-order": 12,
"description": "Internal only: our team's key for reference_audio. Public calls leave it empty."
},
"trim_text": {
"type": "boolean",
"title": "Trim Text",
"default": true,
"x-order": 8,
"description": "Run the text encoder on the real prompt tokens only (fast)."
},
"output_format": {
"enum": [
"mp3",
"wav"
],
"type": "string",
"title": "output_format",
"description": "Audio format (mp3 = mono 96 kbps, wav = stereo 16-bit).",
"default": "mp3",
"x-order": 7
},
"reference_text": {
"type": "string",
"title": "Reference Text",
"default": "",
"x-order": 11,
"description": "Internal only: the exact words spoken in reference_audio."
},
"reference_audio": {
"type": "string",
"title": "Reference Audio",
"format": "uri",
"x-order": 10,
"description": "Internal only (needs clone_key): a 1.5-8.5 s clean speech clip whose voice the new words continue in."
}
}
}
Output schema
The shape of the response you’ll get when you run this model with an API.
Schema
{
"type": "string",
"title": "Output",
"format": "uri"
}