Model ID

skyreels-v4-text-to-video

Calling method: async

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

Parameter	Type	Required	Description	Default	Constraints
`model`	string	Yes	Model identifier	-	Must be `"skyreels-v4-text-to-video"`
`payload.prompt`	string	Yes	Text prompt describing the video to generate	-	Max length: 1280 tokens
`payload.duration`	integer	No	Duration of the generated video in seconds	5	Min: 3, Max: 15
`payload.aspect_ratio`	string (enum)	No	Aspect ratio of the generated video	”16:9”	Options: “16:9”, “4:3”, “1:1”, “9:16”, “3:4”
`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": "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

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

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

skyreels-v4-text-to-video

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

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

List Available Models

Endpoint

Example

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

​Overview

​Authentication

​Submit Video Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

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

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

List Available Models

Endpoint

Example