Skip to main content
Model ID 
skyreels-v4-text-to-video

​
skyreels-v4-text-to-video API Usage Guide

​
Overview

skyreels-v4-text-to-video generates high-definition 1080p video from text prompts with optional sound effects and flexible aspect ratios. 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

​
Request Format

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-text-to-video",
    "payload": {
      "prompt": "A drone flying over a lush green valley at golden hour with cinematic motion",
      "duration": 5,
      "aspect_ratio": "16:9",
      "sound": false,
      "mode": "std"
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
modelstringYesModel identifier-Must be "skyreels-v4-text-to-video"
payload.promptstringYesText prompt describing the video to generate-Max length: 1280 tokens
payload.durationintegerNoDuration of the generated video in seconds5Min: 3, Max: 15
payload.aspect_ratiostring (enum)NoAspect ratio of the generated video”16:9”Options: “16:9”, “4:3”, “1:1”, “9:16”, “3:4”
payload.soundbooleanNoWhether the generated video includes sound effectsfalse14 credits/s with sound, 12 credits/s without
payload.modestring (enum)NoQuality/performance mode”std”Options: “fast”, “std”, “pro”; currently only “std” is supported

​
Response

{
  "request_id": "660f9500-f30c-52e5-b827-557766550000",
  "model": "skyreels-v4-text-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/660f9500-f30c-52e5-b827-557766550000" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "request_id": "660f9500-f30c-52e5-b827-557766550000",
  "org_id": "your-org-id",
  "model": "skyreels-v4-text-to-video",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A drone flying over a lush green valley at golden hour with cinematic motion",
    "duration": 5,
    "aspect_ratio": "16:9",
    "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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest was cancelled

​
List Your Requests

​
Endpoint

GET /api/v1/ie/requestqueue/apikey/requests?model_id=skyreels-v4-text-to-video

​
Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=skyreels-v4-text-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"