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 Pro Retake (Video Section Edit) API Usage Guide
Overview
LTX-2 Pro Retake allows you to edit a specific section of a video by replacing audio, video, or both using AI generation. Define the section with start_time and duration. It operates synchronously and returns the edited video directly.
Key Features:
- Synchronous Operation: Results returned directly
- Flexible Editing: Replace audio only, video only, or both
- Section-Based: Edit specific time ranges within a video
- Max Input: 4K resolution, 21 seconds duration
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-pro-retake",
"payload": {
"video_uri": "https://example.com/input.mp4",
"start_time": 0,
"duration": 5,
"prompt": "A dramatic explosion with bright orange flames",
"mode": "replace_audio_and_video"
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
video_uri | string | Yes | Input video URL for editing. | - | Max 4K, max 21 seconds |
start_time | float | Yes | Start time of the section to edit, in seconds. | 0 | Min 0 |
duration | float | Yes | Duration of the section to edit, in seconds. | 5 | Min 2 seconds |
prompt | string | No | Text description of what should happen in the edited section. | - | - |
mode | enum | No | What to replace. | replace_audio_and_video | replace_audio_and_video, replace_audio, replace_video |
Response
{
"request_id": "abc123",
"model": "ltx-2-pro-retake",
"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-pro-retake",
"status": "success",
"payload": {
"video_uri": "https://example.com/input.mp4",
"start_time": 0,
"duration": 5,
"prompt": "A dramatic explosion with bright orange flames",
"mode": "replace_audio_and_video"
},
"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-pro-retake
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/ltx-2-pro-retake
Edit Modes
| Mode | Description |
|---|
replace_audio_and_video | Replace both the audio and video tracks (default) |
replace_audio | Replace only the audio track, keep original video |
replace_video | Replace only the video track, keep original audio |
Specifications
| Specification | Value |
|---|
| Model | ltx-2-pro |
| Max input resolution | 4K (3840x2160) |
| Max input duration | 21 seconds |
| Min edit duration | 2 seconds |
