Model ID

ltx-2-pro-image-to-video

LTX-2 Pro Image-to-Video API Usage Guide

Overview

LTX-2 Pro Image-to-Video transforms a static image into a premium-quality dynamic video using the LTX-2 Pro model. Provide an image URL and a text prompt to guide the AI animation. It operates synchronously and returns the video directly (typically 30-120 seconds).

Key Features:

Synchronous Operation: Results returned directly
Premium Quality: Higher fidelity output than Fast model
Image-Driven: Use any image as the first frame
Multiple Resolutions: 1080p, 1440p, 4K
Optional Audio: AI-generated audio matching the scene
Camera Motion: Built-in camera motion effects

Authentication

All API requests require authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Submit Request

Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ltx-2-pro-image-to-video",
    "payload": {
      "image_uri": "https://example.com/landscape.jpg",
      "prompt": "Clouds slowly drift across the sky, sunlight shifts",
      "duration": 8,
      "resolution": "1920x1080"
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`image_uri`	image	Yes	Image URL to use as the first frame. Supported: JPEG, PNG, WebP.	-	Max 1 image
`prompt`	string	Yes	Text description of how the image should be animated.	-	Required
`duration`	enum	Yes	Video duration in seconds.	6	6, 8, 10
`resolution`	enum	Yes	Output video resolution.	1920x1080	`1920x1080`, `2560x1440`, `3840x2160`
`fps`	enum	No	Frame rate.	25	25, 50
`generate_audio`	boolean	No	Generate AI audio matching the scene.	true	-
`camera_motion`	enum	No	Camera motion effect.	-	dolly_in, dolly_out, dolly_left, dolly_right, jib_up, jib_down, static, focus_shift

Response

{
  "request_id": "abc123",
  "model": "ltx-2-pro-image-to-video",
  "status": "success",
  "created_at": 1761763441,
  "updated_at": 1761763521
}

Check Request Status

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/{request_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "abc123",
  "model": "ltx-2-pro-image-to-video",
  "status": "success",
  "payload": {
    "image_uri": "https://example.com/landscape.jpg",
    "prompt": "Clouds slowly drift across the sky, sunlight shifts",
    "duration": 8,
    "resolution": "1920x1080"
  },
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/.../video.mp4"
      }
    ]
  },
  "created_at": 1761763441,
  "updated_at": 1761763521,
  "queued_at": 1761763441
}

Request Status Values

Status	Description
`queued`	Request is waiting to be processed
`processing`	Video generation is in progress
`success`	Video generation completed successfully
`failed`	Video generation failed
`cancelled`	Request was cancelled

List Your Requests

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests?model_id=ltx-2-pro-image-to-video

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/ltx-2-pro-image-to-video

Model Support Matrix

Resolution	FPS	Duration (seconds)
1920x1080	25, 50	6, 8, 10
2560x1440	25, 50	6, 8, 10
3840x2160	25, 50	6, 8, 10

LTX 2 Pro Audio-to-Video LTX 2 Pro Retake

​LTX-2 Pro Image-to-Video API Usage Guide

​Overview

​Key Features:

​Authentication

​Submit Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Get Model Information

​Endpoint

​Model Support Matrix

LTX-2 Pro Image-to-Video API Usage Guide

Overview

Key Features:

Authentication

Submit Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Get Model Information

Endpoint

Model Support Matrix