LTX-2.5 — Image to video pro API

← LTX-2.5 Endpoint: POST https://api.higgsfield.ai/lightricks/ltx-2.5/image-to-video/pro Endpoint ID: lightricks/ltx-2.5/image-to-video/pro ▶Open API PlaygroundLTX-2.5 · Image to video pro↗

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.
Pro supports 720p or 1080p and 24, 25 or 50 fps. Use the Fast endpoint for 2k, 4k or 48 fps.
image_url is the required first frame; end_image_url is an optional last frame. aspect_ratio explicitly controls output dimensions.

Quick start

Replace the example media URLs with publicly accessible URLs for your own files before submitting.

curl --request POST \
  --url https://api.higgsfield.ai/lightricks/ltx-2.5/image-to-video/pro \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
  "duration": 6,
  "image_url": "https://example.com/input.jpg"
}'

import higgsfield_client

arguments = (
    {'prompt': 'A cinematic wide shot of ocean waves at sunset, with gentle camera '
               'movement.',
     'duration': 6,
     'image_url': 'https://example.com/input.jpg'}
)
result = higgsfield_client.subscribe(
    "lightricks/ltx-2.5/image-to-video/pro",
    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/image-to-video/pro", {
  input:
    {
      "prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
      "duration": 6,
      "image_url": "https://example.com/input.jpg"
    },
  withPolling: true,
});

if (result.status === "completed") {
  console.log(result.video?.url);
}

Input schema

integer

default:"25"

Allowed values: 24, 25, 50.

string

required

Write your prompt here Minimum characters: 2. Maximum characters: 5000.

integer

default:"6"

required

Requested output duration in seconds. Allowed values: 6, 8, 10. The server supplies this default when the field is omitted.

string

required

Public URL of the input image. Format: uri.

string

default:"720p"

Output resolution tier. Allowed values: "720p", "1080p".

string

default:"16:9"

Output width-to-height ratio. Allowed values: "16:9", "9:16".

string

Format: uri.

boolean

default:"true"

Generate audio with the video.

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 Pro Image to Video Playground",
  "required": [
    "prompt",
    "duration",
    "image_url"
  ],
  "properties": {
    "fps": {
      "enum": [
        24,
        25,
        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
    },
    "image_url": {
      "type": "string",
      "title": "First frame",
      "format": "uri"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "720p"
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16"
      ],
      "type": "string",
      "title": "Aspect ratio",
      "default": "16:9"
    },
    "end_image_url": {
      "type": "string",
      "title": "Last frame",
      "format": "uri"
    },
    "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.

Accepted

{
  "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 polling, request errors and authentication for shared request handling.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

LTX-2.5 — Image to video pro API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response