PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Skyreels
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
      • Create Task
      • Kling Virtual Try-On
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • LLM
      • Use Cases for GPT-4o Image API
      • How To Avoid Timeouts in Completion API
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • Get Task
    • WanX
      • Available LoRA Types for Wanx
      • Generate WanX Task with LoRA Using PiAPI
      • Use Cases for Wanx LoRA
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
        POST
      • Get Task
        GET
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
      • Reroll
      • Upscale
      • Variation
      • Inpaint
      • Outpaint
      • Pan
      • Describe
      • Blend
      • Seed
      • Fetch
      • Multi Fetch
      • Cancel
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Skyreels

Create Task

POST
/api/v1/task
Video Generation

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
        }
    }
}'

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
Modified at 2025-02-28 08:43:42
Previous
Get Task
Next
Get Task