Kling Image-to-Video kling-v3

Kling Image-to-Video Task (kling-v3)

curl --request POST \
  --url https://api.powertokens.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model_name": "kling-v3",
  "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
  "image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
  "prompt": "Camera pulls back, the girl smiles",
  "negative_prompt": "",
  "duration": "5",
  "mode": "pro",
  "sound": "off",
  "callback_url": "",
  "external_task_id": ""
}
'

import requests

url = "https://api.powertokens.ai/kling/v1/videos/image2video"

payload = {
    "model_name": "kling-v3",
    "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
    "image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
    "prompt": "Camera pulls back, the girl smiles",
    "negative_prompt": "",
    "duration": "5",
    "mode": "pro",
    "sound": "off",
    "callback_url": "",
    "external_task_id": ""
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    model_name: 'kling-v3',
    image: 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png',
    image_tail: 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png',
    prompt: 'Camera pulls back, the girl smiles',
    negative_prompt: '',
    duration: '5',
    mode: 'pro',
    sound: 'off',
    callback_url: '',
    external_task_id: ''
  })
};

fetch('https://api.powertokens.ai/kling/v1/videos/image2video', 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://api.powertokens.ai/kling/v1/videos/image2video",
  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_name' => 'kling-v3',
    'image' => 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png',
    'image_tail' => 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png',
    'prompt' => 'Camera pulls back, the girl smiles',
    'negative_prompt' => '',
    'duration' => '5',
    'mode' => 'pro',
    'sound' => 'off',
    'callback_url' => '',
    'external_task_id' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: <content-type>"
  ],
]);

$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://api.powertokens.ai/kling/v1/videos/image2video"

	payload := strings.NewReader("{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")

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

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "Bearer <token>")

	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.powertokens.ai/kling/v1/videos/image2video")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.powertokens.ai/kling/v1/videos/image2video")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = 'Bearer <token>'
request.body = "{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}"

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

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "string",
    "task_info": {
      "external_task_id": "string"
    },
    "task_status": "submitted",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

POST

kling

videos

image2video

Kling Image-to-Video Task (kling-v3)

curl --request POST \
  --url https://api.powertokens.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model_name": "kling-v3",
  "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
  "image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
  "prompt": "Camera pulls back, the girl smiles",
  "negative_prompt": "",
  "duration": "5",
  "mode": "pro",
  "sound": "off",
  "callback_url": "",
  "external_task_id": ""
}
'

import requests

url = "https://api.powertokens.ai/kling/v1/videos/image2video"

payload = {
    "model_name": "kling-v3",
    "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
    "image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
    "prompt": "Camera pulls back, the girl smiles",
    "negative_prompt": "",
    "duration": "5",
    "mode": "pro",
    "sound": "off",
    "callback_url": "",
    "external_task_id": ""
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    model_name: 'kling-v3',
    image: 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png',
    image_tail: 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png',
    prompt: 'Camera pulls back, the girl smiles',
    negative_prompt: '',
    duration: '5',
    mode: 'pro',
    sound: 'off',
    callback_url: '',
    external_task_id: ''
  })
};

fetch('https://api.powertokens.ai/kling/v1/videos/image2video', 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://api.powertokens.ai/kling/v1/videos/image2video",
  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_name' => 'kling-v3',
    'image' => 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png',
    'image_tail' => 'https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png',
    'prompt' => 'Camera pulls back, the girl smiles',
    'negative_prompt' => '',
    'duration' => '5',
    'mode' => 'pro',
    'sound' => 'off',
    'callback_url' => '',
    'external_task_id' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: <content-type>"
  ],
]);

$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://api.powertokens.ai/kling/v1/videos/image2video"

	payload := strings.NewReader("{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")

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

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "Bearer <token>")

	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.powertokens.ai/kling/v1/videos/image2video")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.powertokens.ai/kling/v1/videos/image2video")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = 'Bearer <token>'
request.body = "{\n  \"model_name\": \"kling-v3\",\n  \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n  \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n  \"prompt\": \"Camera pulls back, the girl smiles\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"off\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}"

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

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "string",
    "task_info": {
      "external_task_id": "string"
    },
    "task_status": "submitted",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> in the request header.

Headers

Content-Type

string

default:application/json

required

Data exchange format

Body

application/json

model_name

enum<string>

required

Model name

Available options:

kling-v3

prompt

string

required

Positive text prompt

Omni models can achieve various capabilities through prompts with subjects, images, videos, etc.:
- Use <<<>>> format to specify a subject, image, or video, e.g.: <<<element_1>>>, <<<image_1>>>, <<<video_1>>>

Must not exceed 2500 characters
Must not be empty when multi_shot is false or shot_type is intelligence.
Use <<<voice_1>>> to specify a voice, with the index matching the order of voices referenced in voice_list
Up to 2 voices per video generation task; when specifying voices, sound must be 'on'
Keep syntax as simple as possible, e.g.: A man<<<voice_1>>>says: "Hello"
When voice_list is not empty and prompt references a voice ID, billing is based on 'with specified voice'

Maximum string length: 2500

image

string

Reference image

Supports image Base64 encoding or image URL (must be accessible)
Note: Please ensure all image data parameters use Base64 encoding format. When using Base64, do not add any prefix (such as data:image/png;base64,) before the Base64 string — pass the Base64 encoded string directly.
Correct Base64 parameter:

iVBORw0KGgoAAAANSUhEUgAAAAUA...

Incorrect Base64 parameter (contains data: prefix):

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

Supported image formats: .jpg / .jpeg / .png
Image file size must not exceed 10MB, image dimensions must be at least 300px, aspect ratio between 1:2.5 ~ 2.5:1
At least one of image or image_tail must be provided; both cannot be empty

image_tail

string

Reference image - tail frame control

Supports image Base64 encoding or image URL (must be accessible)
Note: When using Base64, do not add any prefix (such as data:image/png;base64,) before the Base64 string — pass the Base64 encoded string directly.
Supported image formats: .jpg / .jpeg / .png
Image file size must not exceed 10MB, image dimensions must be at least 300px
At least one of image or image_tail must be provided; both cannot be empty
image_tail and dynamic_masks/static_mask are mutually exclusive; cannot be used together

multi_shot

boolean

default:false

Whether to generate a multi-shot video. When this parameter is true, the prompt parameter is invalid. When this parameter is false, the shot_type and multi_prompt parameters are invalid.

shot_type

enum<string>

Shot type Required when multi_shot is true.

Available options:

customize,

intelligence

multi_prompt

object[]

Multi-shot information including prompt, duration, etc. Define shot index and corresponding prompt and duration via index, prompt, duration parameters.

Max 6 shots, min 1 shot.
Max length per shot content: 512 characters.
Each shot duration must not exceed total task duration and must be >= 1.
Sum of all shot durations must equal total task duration.

When multi_shot is true and shot_type is customize, this parameter must not be empty. Format:

"multi_prompt":[{ "index": int, "prompt": "string", "duration": "5" },{ "index": int, "prompt": "string","duration": "5" }]

Required when multi_shot is true and shot_type is customize.

Required array length: 1 - 6 elements

Show child attributes

negative_prompt

string

Negative text prompt

Must not exceed 2500 characters
It is recommended to supplement negative prompt information through negative sentences in the positive prompt

Maximum string length: 2500

element_list

object[]

Element reference list, configured based on element IDs in the element library.

Up to 3 reference elements

Elements are divided into video character elements and multi-image elements, with different applicable scopes.

Use key:value format:

"element_list":[{ "element_id": long },{ "element_id": long }]

Maximum array length: 3

Show child attributes

voice_list

object[]

Voice list referenced during video generation.

Up to 2 voices per video generation task
When voice_list is not empty and prompt references a voice ID, billing is based on 'with specified voice'
element_list and voice_list are mutually exclusive; cannot coexist

Use key:value format:

"voice_list":[{ "voice_id": "string" },{ "voice_id": "string" }]

Maximum array length: 2

Show child attributes

sound

enum<string>

default:off

Whether to also generate audio when creating the video

Available options:

on,

off

cfg_scale

number

default:0.5

Creative freedom of video generation; higher values result in less model freedom and stronger correlation with the user's input prompt

Required range: 0 <= x <= 1

mode

enum<string>

default:std

Video generation mode

std: Standard mode, cost-effective, output video resolution 720P.
pro: Expert mode (high quality), better video quality, output video resolution 1080P.
4k: 4K mode, high quality (same as pro), better video quality, output video resolution 4K.

Available options:

std,

pro,

4k

static_mask

string

Static brush mask area (mask image painted by the user via motion brush) The "motion brush" feature includes both "dynamic brush dynamic_masks" and "static brush static_mask"

Supports image Base64 encoding or image URL (must be accessible, same format requirements as the image field)
Supported image formats: .jpg / .jpeg / .png
Image aspect ratio must match the input image (i.e., the image field), otherwise the task will fail
The resolution of static_mask and dynamic_masks.mask must be identical, otherwise the task will fail

dynamic_masks

object[]

Dynamic brush configuration list

Can configure multiple groups (up to 6), each containing a "mask area" and "motion trajectories" sequence

Maximum array length: 6

Show child attributes

duration

enum<string>

default:5

Video duration in seconds.

Available options:

3,

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

watermark_info

object

Whether to also generate a watermarked result.

Show child attributes

callback_url

string

Callback notification URL for this task. If configured, the server will proactively notify when the task status changes.

external_task_id

string

Custom task ID.

Does not override the system-generated task ID, but supports querying by this ID.
Must be unique per user.

Response

200 - application/json

Task accepted.

code

integer

Error code; see error codes for details.

message

string

Error message.

request_id

string

Request ID, system-generated, used for request tracking and troubleshooting.

data

object

Show child attributes

Kling Image-to-Video kling-v2-5-turbo

Kling Motion Control kling-v3

Chat Models

Image Models

Video Models

Audio Models

asset library

Kling Image-to-Video kling-v3

Authorizations

Headers

Body

Response