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

# skyreels-v4-text-to-video

> API usage guide for skyreels-v4-text-to-video.

{/* source_model_id: skyreels-v4-text-to-video */}

{/* source_updated_at: 1781741095 */}

**Model ID**

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "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

```bash theme={null}
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

```json theme={null}
{
  "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

```bash theme={null}
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

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```