> ## 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 Fast Image-to-Video

> Transform a static image into a dynamic video using the LTX-2 Fast model.

**Model ID**

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

```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-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

```json theme={null}
{
  "request_id": "abc123",
  "model": "ltx-2-fast-image-to-video",
  "status": "success",
  "created_at": 1761763441,
  "updated_at": 1761763481
}
```

## 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-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

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

## Get Model Information

### Endpoint

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


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