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