Model ID

ltx-2-fast-image-to-video

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

Overview

LTX-2 Fast Image-to-Video transforms a static image into a dynamic video using the LTX-2 Fast 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
Image-Driven: Use any image as the first frame
Multiple Resolutions: 1080p, 1440p, 4K
Extended Duration: Up to 20 seconds at 1080p@25fps; up to 10 seconds at higher resolutions
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-fast-image-to-video",
    "payload": {
      "image_uri": "https://example.com/photo.jpg",
      "prompt": "The scene gently comes to life with soft movement",
      "duration": 6,
      "resolution": "1920x1080",
      "fps": 25,
      "generate_audio": true
    }
  }'

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, 12, 14, 16, 18, 20 (12-20 only at 1080p@25fps)
`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-fast-image-to-video",
  "status": "success",
  "created_at": 1761763441,
  "updated_at": 1761763481
}

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-fast-image-to-video",
  "status": "success",
  "payload": {
    "image_uri": "https://example.com/photo.jpg",
    "prompt": "The scene gently comes to life with soft movement",
    "duration": 6,
    "resolution": "1920x1080"
  },
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/.../video.mp4"
      }
    ]
  },
  "created_at": 1761763441,
  "updated_at": 1761763481,
  "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-fast-image-to-video

Get Model Information

Endpoint

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

Model Support Matrix

Resolution	FPS	Duration (seconds)
1920x1080	25	6, 8, 10, 12, 14, 16, 18, 20
1920x1080	50	6, 8, 10
2560x1440	25, 50	6, 8, 10
3840x2160	25, 50	6, 8, 10

Overview

Model Quickstarts

Agents

Coding Tools

Agentbox Guides

Migration Guides

LTX 2 Fast Image-to-Video

LTX-2 Fast 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 Fast 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 Fast 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