LTX-2.5 — Text to video fast API
Text to video fast with LTX-2.5: request parameters, examples and response handling.
Endpoint: POST https://api.higgsfield.ai/lightricks/ltx-2.5/text-to-video/fast
Endpoint ID: lightricks/ltx-2.5/text-to-video/fast
#Usage notes
- duration is marked required in the schema and has default 6; the API applies this top-level default before validation. The example includes it explicitly.
- Fast supports 720p, 1080p, 2k or 4k and 24, 25, 48 or 50 fps.
#Quick start
curl --request POST \
--url https://api.higgsfield.ai/lightricks/ltx-2.5/text-to-video/fast \
--header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
--data '{
"prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
"duration": 6
}'
import higgsfield_client
arguments = (
{'prompt': 'A cinematic wide shot of ocean waves at sunset, with gentle camera '
'movement.',
'duration': 6}
)
result = higgsfield_client.subscribe(
"lightricks/ltx-2.5/text-to-video/fast",
arguments=arguments,
)
print(result["video"]["url"])
import { config, higgsfield } from "@higgsfield/client/v2";
config({ credentials: process.env.HF_CREDENTIALS });
const result = await higgsfield.subscribe("lightricks/ltx-2.5/text-to-video/fast", {
input:
{
"prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
"duration": 6
},
withPolling: true,
});
if (result.status === "completed") {
console.log(result.video?.url);
}
#Input schema
fps integer (default: 25)
Allowed values: 24, 25, 48, 50.
prompt string required
Write your prompt here
Minimum characters: 2.
Maximum characters: 5000.
duration integer required (default: 6)
Requested output duration in seconds.
Allowed values: 6, 8, 10.
The server supplies this default when the field is omitted.
resolution string (default: 720p)
Output resolution tier.
Allowed values: "720p", "1080p", "2k", "4k".
aspect_ratio string (default: 16:9)
Output width-to-height ratio.
Allowed values: "16:9", "9:16".
generate_audio boolean (default: true)
Generate audio with the video.
camera_movement string
Allowed values: "dolly_in", "dolly_out", "dolly_left", "dolly_right", "jib_up", "jib_down", "static", "focus_shift".
Complete JSON schema
{
"type": "object",
"title": "LTX-2.5 Fast Text to Video Playground",
"required": [
"prompt",
"duration"
],
"properties": {
"fps": {
"enum": [
24,
25,
48,
50
],
"type": "integer",
"title": "Frames per second",
"default": 25
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 5000,
"minLength": 2,
"description": "Write your prompt here"
},
"duration": {
"enum": [
6,
8,
10
],
"type": "integer",
"title": "Duration",
"default": 6
},
"resolution": {
"enum": [
"720p",
"1080p",
"2k",
"4k"
],
"type": "string",
"title": "Resolution",
"default": "720p"
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16"
],
"type": "string",
"title": "Aspect ratio",
"default": "16:9"
},
"generate_audio": {
"type": "boolean",
"title": "Generate audio",
"default": true
},
"camera_movement": {
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"focus_shift"
],
"type": "string",
"title": "Camera movement"
}
},
"additionalProperties": false
}
#Response
Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
{
"status": "queued",
"request_id": "REQUEST_ID",
"status_url": "https://api.higgsfield.ai/requests/REQUEST_ID/status",
"cancel_url": "https://api.higgsfield.ai/requests/REQUEST_ID/cancel"
}
A completed response includes the following output fields:
{
"status": "completed",
"request_id": "REQUEST_ID",
"video": {
"url": "https://example.com/output.mp4"
}
}
See idempotent requests, polling, request errors and authentication for shared request handling.