Kling v2.6 Video Generation

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "mode": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "reference_images": [
    "<string>"
  ],
  "image_with_roles": [
    {
      "url": "<string>",
      "role": "<string>"
    }
  ],
  "negative_prompt": "<string>",
  "audio": true,
  "watermark": true
}
'

import requests

url = "https://toapis.com/v1/videos/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "mode": "<string>",
    "duration": 123,
    "aspect_ratio": "<string>",
    "reference_images": ["<string>"],
    "image_with_roles": [
        {
            "url": "<string>",
            "role": "<string>"
        }
    ],
    "negative_prompt": "<string>",
    "audio": True,
    "watermark": True
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    mode: '<string>',
    duration: 123,
    aspect_ratio: '<string>',
    reference_images: ['<string>'],
    image_with_roles: [{url: '<string>', role: '<string>'}],
    negative_prompt: '<string>',
    audio: true,
    watermark: true
  })
};

fetch('https://toapis.com/v1/videos/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toapis.com/v1/videos/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'mode' => '<string>',
    'duration' => 123,
    'aspect_ratio' => '<string>',
    'reference_images' => [
        '<string>'
    ],
    'image_with_roles' => [
        [
                'url' => '<string>',
                'role' => '<string>'
        ]
    ],
    'negative_prompt' => '<string>',
    'audio' => true,
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://toapis.com/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}")

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

	req.Header.Add("Authorization", "<authorization>")
	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://toapis.com/v1/videos/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://toapis.com/v1/videos/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

POST

videos

generations

Kling v2.6 Video Generation

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "mode": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "reference_images": [
    "<string>"
  ],
  "image_with_roles": [
    {
      "url": "<string>",
      "role": "<string>"
    }
  ],
  "negative_prompt": "<string>",
  "audio": true,
  "watermark": true
}
'

import requests

url = "https://toapis.com/v1/videos/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "mode": "<string>",
    "duration": 123,
    "aspect_ratio": "<string>",
    "reference_images": ["<string>"],
    "image_with_roles": [
        {
            "url": "<string>",
            "role": "<string>"
        }
    ],
    "negative_prompt": "<string>",
    "audio": True,
    "watermark": True
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    mode: '<string>',
    duration: 123,
    aspect_ratio: '<string>',
    reference_images: ['<string>'],
    image_with_roles: [{url: '<string>', role: '<string>'}],
    negative_prompt: '<string>',
    audio: true,
    watermark: true
  })
};

fetch('https://toapis.com/v1/videos/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toapis.com/v1/videos/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'mode' => '<string>',
    'duration' => 123,
    'aspect_ratio' => '<string>',
    'reference_images' => [
        '<string>'
    ],
    'image_with_roles' => [
        [
                'url' => '<string>',
                'role' => '<string>'
        ]
    ],
    'negative_prompt' => '<string>',
    'audio' => true,
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://toapis.com/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}")

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

	req.Header.Add("Authorization", "<authorization>")
	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://toapis.com/v1/videos/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://toapis.com/v1/videos/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"image_with_roles\": [\n    {\n      \"url\": \"<string>\",\n      \"role\": \"<string>\"\n    }\n  ],\n  \"negative_prompt\": \"<string>\",\n  \"audio\": true,\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

Note for users in mainland China: Please use https://toapis.cn as the API endpoint (Base URL). Replace https://toapis.com with https://toapis.cn in the examples in this document.

Async processing mode, returns task ID for subsequent queries
Supports text-to-video, image-to-video, explicit first/last frame control, and audio video
Supports standard mode (720P) and professional mode (1080P)
Professional mode supports automatic audio generation

Authorization

string

required

All API endpoints require Bearer Token authentication.

Authorization: Bearer YOUR_API_KEY

Request Parameters

string

required

Video generation model name, fixed as kling-v2-6.

string

required

Text prompt, maximum 2500 characters.

string

default:"std"

Generation mode.

std - standard mode (720P, silent video only)
pro - professional mode (1080P, supports automatic audio generation)

integer

default:"5"

Video duration in seconds.Options: 5 or 10

string

default:"16:9"

Video aspect ratio. Common values: 16:9, 9:16, 1:1

string[]

Normal reference images.

These images are treated as references only
They are not automatically converted into first/last frames
Use image_with_roles for explicit frame control

object[]

Explicit image-role array for frame control and mixed inputs.

Show Show image_with_roles object fields

string

required

Publicly accessible image URL.

string

required

Image role.Supported values:

first_frame
last_frame
reference
reference_image

last_frame is only sent when explicitly declared in image_with_roles. The system no longer infers the last frame from reference_images[1].

string

Negative prompt to exclude unwanted content.

boolean

default:"false"

Whether to automatically generate audio.

Available only in mode: "pro".

boolean

Whether to add watermark.

Input Rules

Input shape	Behavior
`reference_images` only	Normal references
`image_with_roles` with only `first_frame` / `last_frame`	Frame control
Both fields used together, or roles include both frame and reference semantics	Mixed mode

Examples

Text-to-Video

{
  "model": "kling-v2-6",
  "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Image Reference

{
  "model": "kling-v2-6",
  "prompt": "Animate the referenced portrait with a subtle smile",
  "reference_images": ["https://example.com/reference.jpg"],
  "mode": "std",
  "duration": 5
}

First and Last Frame Control

{
  "model": "kling-v2-6",
  "prompt": "City timelapse transitioning from day to night",
  "image_with_roles": [
    { "url": "https://example.com/day-city.jpg", "role": "first_frame" },
    { "url": "https://example.com/night-city.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}

Mixed Reference and Frame Input

{
  "model": "kling-v2-6",
  "prompt": "Keep the character identity while moving from one scene to another",
  "reference_images": ["https://example.com/character-reference.jpg"],
  "image_with_roles": [
    { "url": "https://example.com/start-scene.jpg", "role": "first_frame" },
    { "url": "https://example.com/end-scene.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}

Pro Mode + Auto Audio

{
  "model": "kling-v2-6",
  "prompt": "Waves crashing against rocks, seagulls circling in the sky, lighthouse in the distance",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}

Video generation is an async task. Use the Get Video Task Status endpoint to query progress and results.

Overview

Quick Start

Model Catalog

Chat API

Image API

Video API

Music API

Task Management

File Uploads

Account

FAQs

Kling v2.6 Video Generation

Authorization

Request Parameters

Input Rules

Examples

Text-to-Video

Image Reference

First and Last Frame Control

Mixed Reference and Frame Input

Pro Mode + Auto Audio

​Authorization

​Request Parameters

​Input Rules

​Examples

​Text-to-Video

​Image Reference

​First and Last Frame Control

​Mixed Reference and Frame Input

​Pro Mode + Auto Audio

Authorization

Request Parameters

Input Rules

Examples

Text-to-Video

Image Reference

First and Last Frame Control

Mixed Reference and Frame Input

Pro Mode + Auto Audio