Kling Series

POST

tasks

Kling Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "n": 123,
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "negative_prompt": "<string>",
  "generate_audio": true,
  "watermark": true,
  "multi_shot": true,
  "shot_type": "<string>",
  "multi_prompt": [
    {}
  ],
  "element_list": [
    {}
  ],
  "image_with_roles": [
    {}
  ],
  "character_orientation": "<string>",
  "keep_original_sound": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "negative_prompt": "<string>",
    "generate_audio": True,
    "watermark": True,
    "multi_shot": True,
    "shot_type": "<string>",
    "multi_prompt": [{}],
    "element_list": [{}],
    "image_with_roles": [{}],
    "character_orientation": "<string>",
    "keep_original_sound": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    n: 123,
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    negative_prompt: '<string>',
    generate_audio: true,
    watermark: true,
    multi_shot: true,
    shot_type: '<string>',
    multi_prompt: [{}],
    element_list: [{}],
    image_with_roles: [{}],
    character_orientation: '<string>',
    keep_original_sound: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"watermark\": true,\n  \"multi_shot\": true,\n  \"shot_type\": \"<string>\",\n  \"multi_prompt\": [\n    {}\n  ],\n  \"element_list\": [\n    {}\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"character_orientation\": \"<string>\",\n  \"keep_original_sound\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"watermark\": true,\n  \"multi_shot\": true,\n  \"shot_type\": \"<string>\",\n  \"multi_prompt\": [\n    {}\n  ],\n  \"element_list\": [\n    {}\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"character_orientation\": \"<string>\",\n  \"keep_original_sound\": \"<string>\"\n}")
  .asString();

Kuaishou’s Kling video line currently has seven models: kling-3.0-turbo, kling-v2-6 and kling-v3 for general generation, kling-v3-omni and kling-video-o1 for video references and video editing, and kling-v2-6-motion-control and kling-v3-motion-control for motion transfer. They share the task endpoint POST /v1/tasks — switching models means changing model — but their actions, parameters and durations differ; see Available models for the per-model breakdown.

Quick start

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-demo-001" \
  -d '{
    "model": "kling-3.0-turbo",
    "action": "generate",
    "prompt": "A city street after rain, neon reflected in the puddles, slow dolly in",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "action": "generate",
    "prompt": "The subject turns from profile toward the camera, hair moving in the breeze",
    "image_urls": [
      "https://cdn.example.com/first.jpg",
      "https://cdn.example.com/last.jpg"
    ],
    "duration": 5,
    "resolution": "1080p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "action": "generate",
    "prompt": "Waves break against the rocks, gulls overhead, a distant ship horn",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "action": "generate",
    "prompt": "A dancer turns once in soft studio light, stable camera",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "multi_shot": true,
    "shot_type": "customize",
    "multi_prompt": [
      { "index": 1, "prompt": "A dancer steps into frame.", "duration": 2 },
      { "index": 2, "prompt": "The camera holds while she turns.", "duration": 3 }
    ]
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "action": "generate",
    "prompt": "The girl from <<<image_1>>> wears the coat from <<<image_2>>> and walks into the cafe from <<<image_3>>>",
    "image_urls": [
      "https://cdn.example.com/girl.jpg",
      "https://cdn.example.com/coat.jpg",
      "https://cdn.example.com/cafe.jpg"
    ],
    "duration": 5,
    "resolution": "4k"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "action": "generate",
    "prompt": "Keep the camera move of the reference video, swap the subject for <<<image_1>>>",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "video_urls": ["https://cdn.example.com/reference.mp4"],
    "duration": 5,
    "resolution": "720p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "action": "edit",
    "prompt": "Grade the whole clip to golden hour, keep the motion",
    "video_urls": ["https://cdn.example.com/source.mp4"],
    "duration": 0,
    "resolution": "720p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-motion-control",
    "action": "generate",
    "prompt": "The character turns and waves, studio lighting",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "video_urls": ["https://cdn.example.com/motion.mp4"],
    "character_orientation": "video",
    "keep_original_sound": "yes",
    "duration": 0,
    "resolution": "1080p"
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook.

Request parameters

string

required

Model ID; see Available models.

string

default:"generate"

generate — generate a video; supported by all seven models
edit — edit a source video; only kling-v3-omni and kling-video-o1 support it, and video_urls is required

string

required

Video description or edit instruction. On kling-v3-omni and kling-video-o1, <<<image_N>>> references the Nth entry of image_urls (N starts at 1); a prompt without any reference gets <<<image_1>>> prepended. with element_list on kling-v3 and kling-v3-omni, reference a subject as @name.

integer

default:"1"

Number of videos. Value: 1. Each task returns one video.

integer

required

Output duration in seconds, per model:

kling-3.0-turbo, kling-v3, kling-v3-omni — an integer from 3 to 15
kling-v2-6, kling-video-o1 — 5 or 10
kling-v2-6-motion-control, kling-v3-motion-control — 0, meaning the reference video’s length
action: "edit" on kling-v3-omni / kling-video-o1 — 0, meaning the source video’s length

string

default:"720p"

Output resolution tier: 720p or 1080p; kling-v3 and kling-v3-omni also offer 4k.

string

Frame ratio: 16:9, 9:16 or 1:1. The two *-motion-control models do not take this parameter. With reference images, the output follows the input image’s ratio.

string[]

Reference image URLs:

kling-3.0-turbo — up to 1, used as the first frame
kling-v2-6, kling-v3, kling-video-o1 — up to 2; two images act as first and last frame
kling-v3-omni — up to 7, together with multi-image subjects in element_list no more than 7
The two *-motion-control models — required, one character reference image
With video_urls on kling-v3-omni / kling-video-o1 — at most 1; action: "edit" takes no reference image

string[]

Reference video URLs, at most one entry:

kling-v3-omni, kling-video-o1 — a camera/feature reference under action: "generate", the source clip under action: "edit"; 3 to 10 seconds
The two *-motion-control models — required, the motion source clip; up to 30 seconds

string

Negative prompt. Supported by kling-v2-6, kling-v3 and kling-v3-omni.

boolean

default:"false"

Generate native audio. Supported by kling-v2-6, kling-v3 and kling-v3-omni; on kling-v2-6 it requires resolution: "1080p", and on kling-v3-omni it cannot be combined with video_urls.

boolean

Whether to watermark the output video. Supported by every model except kling-video-o1.

Multi-shot and reference subjects (`kling-v3` / `kling-v3-omni`)

boolean

default:"false"

Enable multi-shot storyboard mode.

string

Shot split method: customize / intelligence; required when multi_shot=true.

array

Multi-shot list (1-6 items) of {index, prompt, duration}; index starts at 1 and is contiguous; shot durations must sum to duration; requires multi_shot=true.

array

Reference subjects (up to 3) of {name, description, element_input_urls}; 2-4 images per subject, first one frontal; reference a subject in the prompt as @name.

Role-tagged images (`kling-v3-omni` / `kling-video-o1`)

array

Role-tagged image array of {url, role} (first_frame / last_frame / reference); merged with first_frame_image / last_frame_image.

Motion control (`kling-v2-6-motion-control` / `kling-v3-motion-control`)

string

required

Use the reference image or video for character orientation: image or video. The two values imply different reference-video lengths; see Limits.

string

default:"yes"

Whether to keep the motion reference video’s original audio: yes or no.

See Submit a task for callback_url, callback_events, Prefer: wait, Idempotency-Key, and the maximum-cost header. The Kling series does not support seed, quality or size. Any other parameter returns 400 and is not billed.

Limits

Models	Condition	Limit
All	Every request	Each task returns one video.
`kling-3.0-turbo`	Every request	A prompt is required and at most one first-frame image is accepted.
`kling-3.0-turbo`	`image_urls` provided	Image-to-video follows the input image and does not accept aspect_ratio.
`kling-3.0-turbo`, `kling-v2-6`, `kling-v3`	Every request	An explicit output duration is required.
`kling-v2-6`, `kling-v3`, `kling-v3-omni`, `kling-video-o1`	Every request	A prompt is required.
`kling-v2-6`, `kling-v3`, `kling-video-o1`	Every request	At most two reference images are accepted.
`kling-v3-omni`	Every request	At most seven reference images; reference images and multi-image elements together may not exceed seven.
`kling-v2-6`	`generate_audio: true`	Native audio requires the 1080p pro tier.
`kling-v2-6`	`generate_audio: true`	Native audio cannot be combined with two-image first/last-frame control.
`kling-v2-6`	Two `image_urls` provided	Two-image first/last-frame control requires the 1080p pro tier.
`kling-v3-omni`, `kling-video-o1`	`video_urls` provided	A video reference accepts at most one image and must be one 3 to 10 second video.
`kling-v3-omni`, `kling-video-o1`	`action: "edit"`	Video editing accepts one source video and preserves its duration.
`kling-v3-omni`, `kling-video-o1`	`action: "generate"`	Video generation requires an explicit output duration.
`kling-v3-omni`	`generate_audio: true` with `video_urls`	Video reference cannot be combined with native-audio generation.
`kling-v2-6-motion-control`, `kling-v3-motion-control`	Every request	Motion control requires one image and one video; output duration follows the reference video.
`kling-v2-6-motion-control`, `kling-v3-motion-control`	`character_orientation: "image"`	Image-orientation reference video must be 3 to 10 seconds.
`kling-v2-6-motion-control`, `kling-v3-motion-control`	`character_orientation: "video"`	Video-orientation reference video must be 3 to 30 seconds.

Item	Models	Maximum
Videos per task	All	1
Reference images	`kling-3.0-turbo`, both `*-motion-control`	1
Reference images	`kling-v2-6`, `kling-v3`, `kling-video-o1`	2
Reference images	`kling-v3-omni`	7; 1 with a reference video
Reference video length	`kling-v3-omni`, `kling-video-o1`	10 seconds
Reference video length	`kling-v2-6-motion-control`, `kling-v3-motion-control`	30 seconds
Storyboard shots	`kling-v3`, `kling-v3-omni`	6
Reference subjects	`kling-v3`, `kling-v3-omni`	3, with 2-4 images each

Requests whose duration follows a reference video (both *-motion-control models, and action: "edit") need a video link whose duration can be read. If it cannot, the request returns 400 and is not billed; ordinary MP4 and WebM links work.

Pricing

Billing is resolution tier × output seconds. resolution picks the tier (720p, 1080p or 4k), and the seconds are the clip’s actual output length. The number of reference images does not affect the price. Two situations switch to a different per-second rate while still multiplying by output seconds only:

Native audio — generate_audio: true uses the audio tier. kling-v3 and kling-v3-omni have one at both resolutions; kling-v2-6 has one at 1080p only.
Video reference — on kling-v3-omni and kling-video-o1, supplying video_urls uses the video-reference tier, under both action: "generate" and action: "edit". The reference video’s own length is not billed.

The 4k tier (kling-v3, kling-v3-omni) has a single per-second rate; native audio and a reference video do not change it. Where the output seconds come from:

Requests that carry a concrete duration are billed on that duration.
Requests with duration: 0 (both *-motion-control models, and action: "edit") follow the reference or source video, and are billed on the duration read from that video.

Per-model rates are in price_config on GET /v1/models, and in the console’s Model Market.What a single call actually cost is the cost field on the task response — an integer quota at 500,000 quota = 1 USD.

You are only billed for a successfully generated video. Failed and cancelled tasks, and tasks that return no usable video, are refunded in full. The final charge is the cost field on the task response — an integer quota, not dollars.

Response

Completed task

{
  "task_id": "task-wave1788753089b950634993",
  "model": "kling-v3",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788753089,
  "completed_at": 1788753209,
  "result": {
    "videos": [
      {
        "url": ["https://cdn.example.com/result.mp4"],
        "expires_at": 1789089508
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1788753089b950634993",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1788753089b950634993/cancel"
  },
  "billing_status": "settled",
  "cost": 189000
}

Generated videos are returned in result.videos; expires_at is when the link stops working, so store the file before then. See Query Task Status for the full field list.

Available models

Model ID	Actions	Duration	Resolution	Reference material
`kling-3.0-turbo`	`generate`	3-15s	`720p` `1080p`	1 first-frame image
`kling-v2-6`	`generate`	5s or 10s	`720p` `1080p`	Up to 2 reference images
`kling-v3`	`generate`	3-15s	`720p` `1080p` `4k`	Up to 2 reference images
`kling-v3-omni`	`generate` `edit`	3-15s; `edit` follows the source	`720p` `1080p` `4k`	Up to 7 images, 1 reference video
`kling-video-o1`	`generate` `edit`	5s or 10s; `edit` follows the source	`720p` `1080p`	Up to 2 images, 1 reference video
`kling-v2-6-motion-control`	`generate`	Follows the reference video	`720p` `1080p`	1 image + 1 reference video
`kling-v3-motion-control`	`generate`	Follows the reference video	`720p` `1080p`	1 image + 1 reference video

Picking by capability:

Native audio (generate_audio) — kling-v2-6 (1080p only), kling-v3, kling-v3-omni
Multi-shot storyboards and reference subjects (multi_shot / shot_type / multi_prompt / element_list) — kling-v3, kling-v3-omni
Role-tagged images (image_with_roles) — kling-v3-omni, kling-video-o1
Video editing and video references (action: "edit" / video_urls) — kling-v3-omni, kling-video-o1
Motion transfer (character_orientation / keep_original_sound) — kling-v2-6-motion-control, kling-v3-motion-control
Negative prompts (negative_prompt) — kling-v2-6, kling-v3, kling-v3-omni

Kling Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "n": 123,
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "negative_prompt": "<string>",
  "generate_audio": true,
  "watermark": true,
  "multi_shot": true,
  "shot_type": "<string>",
  "multi_prompt": [
    {}
  ],
  "element_list": [
    {}
  ],
  "image_with_roles": [
    {}
  ],
  "character_orientation": "<string>",
  "keep_original_sound": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "negative_prompt": "<string>",
    "generate_audio": True,
    "watermark": True,
    "multi_shot": True,
    "shot_type": "<string>",
    "multi_prompt": [{}],
    "element_list": [{}],
    "image_with_roles": [{}],
    "character_orientation": "<string>",
    "keep_original_sound": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    n: 123,
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    negative_prompt: '<string>',
    generate_audio: true,
    watermark: true,
    multi_shot: true,
    shot_type: '<string>',
    multi_prompt: [{}],
    element_list: [{}],
    image_with_roles: [{}],
    character_orientation: '<string>',
    keep_original_sound: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"watermark\": true,\n  \"multi_shot\": true,\n  \"shot_type\": \"<string>\",\n  \"multi_prompt\": [\n    {}\n  ],\n  \"element_list\": [\n    {}\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"character_orientation\": \"<string>\",\n  \"keep_original_sound\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"watermark\": true,\n  \"multi_shot\": true,\n  \"shot_type\": \"<string>\",\n  \"multi_prompt\": [\n    {}\n  ],\n  \"element_list\": [\n    {}\n  ],\n  \"image_with_roles\": [\n    {}\n  ],\n  \"character_orientation\": \"<string>\",\n  \"keep_original_sound\": \"<string>\"\n}")
  .asString();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Quick start

Request parameters

Multi-shot and reference subjects (`kling-v3` / `kling-v3-omni`)

Role-tagged images (`kling-v3-omni` / `kling-video-o1`)

Motion control (`kling-v2-6-motion-control` / `kling-v3-motion-control`)

Limits

Pricing

Response

Available models

​Quick start

​Request parameters

​Multi-shot and reference subjects (kling-v3 / kling-v3-omni)

​Role-tagged images (kling-v3-omni / kling-video-o1)

​Motion control (kling-v2-6-motion-control / kling-v3-motion-control)

​Limits

​Pricing

​Response

​Available models

​Related

Quick start

Request parameters

Multi-shot and reference subjects (`kling-v3` / `kling-v3-omni`)

Role-tagged images (`kling-v3-omni` / `kling-video-o1`)

Motion control (`kling-v2-6-motion-control` / `kling-v3-motion-control`)

Limits

Pricing

Response

Available models

Related