PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Kling
  • 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
      • Get Task
    • 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
        POST
      • Video Extend
        POST
      • Get Video Generation
        GET
  1. Kling

Video Generation

POST
/api/kling/v1/video
legacy/Kling
This endpoint from PiAPI's Kling API utilizes Kling AI model by Kuaishou to produce text/image-to-video generation.

Request

Header Params
X-API-key
string 
required
Your API KEY used for request authorization
Body Params application/json
negative_prompt
string 
optional
negative prompt of your video, can be empty
prompt
string 
required
prompt of your video
creativity
number 
optional
a number between 0 to 1, the lower the more creative
duration
number 
optional
can only be 5 or 10, defaults to 5
aspect_ratio
string 
required
can only be 16:9,9:16,1:1
professional_mode
boolean 
optional
PAID KLING PLAN NEEDED. Default to false, visit Kling AI official product to get the definition of professional mode
image_url
string 
optional
initial frame of the video, DO NOT pass this param if you just want text-to-video
tail_image_url
string 
optional
PAID KLING PLAN NEEDED. End frame of the video, DO NOT pass this param if you just want text-to-video
camera
object 
optional
camera control of the video, effective in text-to-image ONLY. TRY it on Kling official website before using this param
type
string 
optional
horizontal
number 
optional
vertical
number 
optional
zoom
number 
optional
tilt
number 
optional
pan
number 
optional
roll
number 
optional
Example
{
  "negative_prompt": "string",
  "prompt": "string",
  "creativity": 0,
  "duration": 0,
  "aspect_ratio": "string",
  "professional_mode": true,
  "image_url": "string",
  "tail_image_url": "string",
  "camera": {
    "type": "string",
    "horizontal": 0,
    "vertical": 0,
    "zoom": 0,
    "tilt": 0,
    "pan": 0,
    "roll": 0
  }
}

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/kling/v1/video' \
--header 'X-API-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "negative_prompt": "string",
    "prompt": "string",
    "creativity": 0,
    "duration": 0,
    "aspect_ratio": "string",
    "professional_mode": true,
    "image_url": "string",
    "tail_image_url": "string",
    "camera": {
        "type": "string",
        "horizontal": 0,
        "vertical": 0,
        "zoom": 0,
        "tilt": 0,
        "pan": 0,
        "roll": 0
    }
}'

Responses

🟢200OK
application/json
OK-Successful Response
Body
code
integer 
optional
data
object 
optional
task_id
string 
optional
message
string 
optional
Example
{
  "code": 0,
  "data": {
    "task_id": "string"
  },
  "message": "string"
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2024-09-24 02:23:40
Previous
Get Video Generation
Next
Video Extend