> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LTX 2 Pro Text-to-Video

> Generate premium-quality videos from text prompts using the LTX-2 Pro model.

**Model ID**

```bash theme={null}
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:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Request

### Endpoint

```text theme={null}
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
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

```json theme={null}
{
  "request_id": "abc123",
  "model": "ltx-2-pro-text-to-video",
  "status": "success",
  "created_at": 1761763441,
  "updated_at": 1761763521
}
```

## Check Request Status

### Endpoint

```text theme={null}
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Example

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

### Response

```json theme={null}
{
  "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

```text theme={null}
GET /api/v1/ie/requestqueue/apikey/requests?model_id=ltx-2-pro-text-to-video
```

## Get Model Information

### Endpoint

```text theme={null}
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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.