Model ID

ltx-2-pro-text-to-video

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

Overview

LTX-2 Pro Text-to-Video generates premium-quality videos from text prompts using the LTX-2 Pro model. Higher quality than Fast, with durations up to 10 seconds at all resolutions. 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
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-text-to-video",
    "payload": {
      "prompt": "A majestic eagle soaring through golden clouds at sunset",
      "duration": 8,
      "resolution": "1920x1080",
      "fps": 25,
      "generate_audio": true,
      "camera_motion": "jib_up"
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	Yes	Text description of the desired video content.	-	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-text-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-text-to-video",
  "status": "success",
  "payload": {
    "prompt": "A majestic eagle soaring through golden clouds at sunset",
    "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-text-to-video

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/ltx-2-pro-text-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

Overview

Model Quickstarts

Agents

Coding Tools

Agentbox Guides

Migration Guides

LTX 2 Pro Text-to-Video

LTX-2 Pro Text-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 Text-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 Text-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