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
skyreels-v4-image-to-video
skyreels-v4-image-to-video API Usage Guide
Overview
skyreels-v4-image-to-video animates a first-frame image into high-definition 1080p video with text-guided motion and optional sound effects.
Requests are sent through the request-queue API and results are fetched by polling.
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Submit Video Generation Request
Base URL
https://console.gmicloud.ai
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": "skyreels-v4-image-to-video",
"payload": {
"prompt": "A cat slowly turns its head and looks at the camera with curious eyes",
"first_frame_image": "https://example.com/cat-photo.jpg",
"duration": 5,
"sound": false,
"mode": "std"
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
model | string | Yes | Model identifier | - | Must be "skyreels-v4-image-to-video" |
payload.prompt | string | Yes | Text prompt describing the video to generate | - | Max length: 1280 tokens |
payload.first_frame_image | string (URL) | Yes | URL of the first frame image | - | Supported formats: jpg/jpeg, png, gif, bmp |
payload.duration | integer | No | Duration of the generated video in seconds | 5 | Min: 3, Max: 15 |
payload.sound | boolean | No | Whether the generated video includes sound effects | false | 14 credits/s with sound, 12 credits/s without |
payload.mode | string (enum) | No | Quality/performance mode | ”std” | Options: “fast”, “std”, “pro”; currently only “std” is supported |
Response
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"model": "skyreels-v4-image-to-video",
"status": "queued",
"created_at": 1750442925,
"updated_at": 1750442925,
"queued_at": 1750442925
}
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/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"org_id": "your-org-id",
"model": "skyreels-v4-image-to-video",
"status": "success",
"is_public": false,
"payload": {
"prompt": "A cat slowly turns its head and looks at the camera with curious eyes",
"first_frame_image": "https://example.com/cat-photo.jpg",
"duration": 5,
"sound": false,
"mode": "std"
},
"outcome": {
"video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
"thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
},
"created_at": 1750442925,
"updated_at": 1750442930,
"queued_at": 1750442925
}
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=skyreels-v4-image-to-video
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=skyreels-v4-image-to-video" \
-H "Authorization: Bearer YOUR_API_KEY"
List Available Models
Endpoint
GET /api/v1/apikey/models
Example
curl -X GET "https://console.gmicloud.ai/api/v1/apikey/models" \
-H "Authorization: Bearer YOUR_API_KEY"
