POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 const axios = require('axios'); const fs = require('fs'); const path = require('path'); async function toB64(imgPath) { const data = fs.readFileSync(path.resolve(imgPath)); return Buffer.from(data).toString('base64'); } const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/ltx-2.5-pro"; const data = { "prompt": "The waterfall thunders down the mossy cliffs, churning the turquoise pool below as mist swirls through golden sunbeams; tropical birds glide across the frame while the camera slowly drifts in. Ambient rainforest sounds of rushing water, distant birdsong and gentle wind.", "image": "toB64('undefined')", "aspect_ratio": "16:9", "resolution": "1080p", "duration": 6, "fps": 24, "generate_audio": true, "camera_motion": "auto", "last_frame_uri": "toB64('undefined')" }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Describe scene, action, camera and audio in one flowing paragraph. Add sound cues for native audio.


imageimage ( default: https://segmind-resources.s3.amazonaws.com/input/ltx-2.5-pro-input-b716084aed.jpg )

Optional first frame; adding it switches to image-to-video. Use a high-resolution JPEG or PNG.


aspect_ratioenum:str ( default: 16:9 )

Output orientation. Use 16:9 for landscape, 9:16 for portrait and social.

Allowed values:


resolutionenum:str ( default: 1080p ) Affects Pricing

Output resolution, 720p or 1080p. Pick 1080p for final delivery, 720p for drafts.

Allowed values:


durationenum:int ( default: 6 ) Affects Pricing

Clip length in seconds: 6, 8 or 10. Use 6 for single actions, 10 for sequences.

Allowed values:


fpsenum:int ( default: 24 )

Frame rate. Choose 24 or 25 for cinematic, 50 for smooth action.

Allowed values:


generate_audiobool ( default: true )

Generates a synchronized audio track. Turn off for silent video.


camera_motionenum:str ( default: auto )

Forces a camera move. Leave on auto to let the prompt drive it.

Allowed values:


last_frame_uriimage ( default: 1 )

Optional closing frame for image-to-video interpolation. Cannot combine with automatic duration.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

LTX 2.5 Pro — Image-to-Video and Text-to-Video with Native Audio

What is LTX 2.5 Pro?

LTX 2.5 Pro is the high-fidelity tier of Lightricks' LTX 2.5 video family, generating video with synchronized audio in a single pass. It handles both text-to-video and image-to-video, producing portrait or landscape clips up to 1080p at cinematic frame rates. Built on a 22-billion-parameter diffusion transformer, it pairs a new Diffusion Video Decoder with Diffusion Fidelity Rendering that allocates compute by scene complexity, so faces, textures, and fast motion hold up frame by frame. Its standout capability is native multi-shot generation: a single prompt can render several connected shots that keep character, environment, lighting, and voice consistent across cuts.

Key Features

  • Text-to-video and image-to-video from one endpoint, up to 1080p in 16:9 or 9:16.
  • Native synchronized audio (ambient sound, music, and dialogue) generated jointly with video.
  • Native multi-shot scenes with consistent characters and voice across explicit cuts.
  • Diffusion Video Decoder and Diffusion Fidelity Rendering for cleaner high-motion output.
  • Automatic duration, camera-motion controls, and first-frame plus last-frame inputs.

Best Use Cases

LTX 2.5 Pro is built for production-quality work: concept films, storyboards, product demos, social ads, and speaking-character shots. Its multi-shot consistency suits branded, narrative content where a character and setting must survive cuts. The image-to-video path animates an approved still with matching audio when you need a locked look. Landscape 16:9 fits cinematic edits, while 9:16 targets vertical social formats.

Prompt Tips and Output Quality

Write one flowing, present-tense paragraph covering shot, scene, action, character, camera, and audio. Put camera moves in their own clause, describe sound explicitly, and place spoken dialogue in quotation marks. Keep on-screen text short and add critical titles in post, since exact spelling across frames is not guaranteed. For multi-shot prompts, name each cut and state audio continuity.

FAQs

Does LTX 2.5 Pro generate audio? Yes, it creates a synchronized track jointly with the video; set generate_audio to false for silent output.

What resolutions and durations are supported? Up to 1080p (720p also) in 16:9 or 9:16, at 6, 8, or 10 seconds and 24, 25, or 50 fps.

Does it support image-to-video? Yes. Supply a first-frame image to switch modes, and optionally a last frame to interpolate toward.

What is native multi-shot generation? One prompt can render multiple connected shots that keep character, lighting, and voice consistent across cuts.

How is Pro different from LTX 2.5 Fast? Pro targets higher fidelity up to 1080p, while Fast trades some quality for speed and reaches up to 4K.