Skyreels API Create Task

Introduction

The Skyreels Img2Video API allows you to generate videos from static images. This model is specially trained for human centric video generation

Model Information

Model: Qubico/skyreels
Task Type: img2video
Description: Transforms static images into high-quality videos based on text prompts.

Pricing

$0.15 per generation

Important Notes

Image Requirements

The input image can be provided as a URL or base64 encoded string.

For best results, provide clear images with good lighting and minimal background distractions.

Faces and human subjects generally produce the best results.

Video Generation Guidelines

Use detailed prompts to guide the video generation process.

Include specific motion descriptions in your prompt (e.g., "camera zooming in slowly," "gentle breeze moving hair").

Specify "FPS-24" in your prompt for optimal frame rate.

The negative prompt can help avoid undesired artifacts or motions.

Aspect Ratio Options

The API supports three aspect ratio options for the output video:

16:9 (Landscape, default)

9:16 (Portrait)

1:1 (Square)

Choose the aspect ratio that best suits your intended platform or use case.

Guidance Scale

The guidance scale parameter (ranging from just above 0 to 10) controls how closely the generated video adheres to your prompt:

Lower values (1-3): More creative freedom, potentially less adherence to the prompt

Medium values (3-5): Balanced adherence to prompt while allowing some creative interpretation

Higher values (5-10): Stricter adherence to the prompt, potentially less creative variation

The default value is 3.5, which provides a good balance for most use cases.

Request

Header Params

x-api-key

string

required

your api key

Body Params application/json

model

string

required

Model to use for generation

Example:

Qubico/skyreels

task_type

string

required

Type of task to perform

Example:

img2video

input

object

required

prompt

string

required

Description of the video to generate

Example:

FPS-24, video of a young woman with long, dark hair and bangs. She is wearing a light gray t-shirt and appears to be sitting at a table.

negative_prompt

string

optional

Description of elements to avoid in the generated video

Example:

chaotic, distortion, morphing

image

string

required

URL or base64 encoded image to transform into video

Example:

https://i.ibb.co/wbw9GLY/girl.webp

aspect_ratio

enum<string>

optional

Aspect ratio of the output video

Allowed values:

16:99:161:1

Default:

16:9

guidance_scale

number <float>

optional

Controls how closely the video adheres to the prompt

<= 10> 0

Default:

3.5

config

object

optional

webhook_config

object

optional

Example

{
    "model": "Qubico/skyreels",
    "task_type": "img2video",
    "input": {
        "prompt": "FPS-24, video of a young woman with long, dark hair and bangs. She is wearing a light gray t-shirt and appears to be sitting at a table.",
        "negative_prompt": "chaotic, distortion, morphing",
        "image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "aspect_ratio": "16:9",
        "guidance_scale": 3.5
    },
    "config": {
        "webhook_config": {
            "endpoint": "string",
            "secret": "string"
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful operation

Body

task_id

string

optional

Unique identifier for the task

status

enum<string>

optional

Current status of the task

Allowed values:

pendingprocessingcompletedfailed

created_at

string <date-time>

optional

Timestamp when the task was created

Example

{
    "task_id": "string",
    "status": "pending",
    "created_at": "2019-08-24T14:15:22Z"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Create Task

Introduction#

Model Information#

Pricing#

Important Notes#

Image Requirements#

Video Generation Guidelines#

Aspect Ratio Options#

Guidance Scale#

Request

Request samples

Responses

Introduction

Model Information

Pricing

Important Notes

Image Requirements

Video Generation Guidelines

Aspect Ratio Options

Guidance Scale