Kling 文生视频 kling-v2-5-turbo

Kling 文生视频任务 (kling-v2-5-turbo)

curl --request POST \
  --url https://api.powertokens.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model_name": "kling-v2-5-turbo",
  "prompt": "一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺",
  "negative_prompt": "",
  "duration": "5",
  "mode": "pro",
  "sound": "on",
  "aspect_ratio": "1:1",
  "callback_url": "",
  "external_task_id": ""
}
'

import requests

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

payload = {
    "model_name": "kling-v2-5-turbo",
    "prompt": "一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺",
    "negative_prompt": "",
    "duration": "5",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "1:1",
    "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-v2-5-turbo',
    prompt: '一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺',
    negative_prompt: '',
    duration: '5',
    mode: 'pro',
    sound: 'on',
    aspect_ratio: '1:1',
    callback_url: '',
    external_task_id: ''
  })
};

fetch('https://api.powertokens.ai/kling/v1/videos/text2video', 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/text2video",
  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-v2-5-turbo',
    'prompt' => '一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺',
    'negative_prompt' => '',
    'duration' => '5',
    'mode' => 'pro',
    'sound' => 'on',
    'aspect_ratio' => '1:1',
    '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/text2video"

	payload := strings.NewReader("{\n  \"model_name\": \"kling-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\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/text2video")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"model_name\": \"kling-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\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

text2video

Kling 文生视频任务 (kling-v2-5-turbo)

curl --request POST \
  --url https://api.powertokens.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model_name": "kling-v2-5-turbo",
  "prompt": "一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺",
  "negative_prompt": "",
  "duration": "5",
  "mode": "pro",
  "sound": "on",
  "aspect_ratio": "1:1",
  "callback_url": "",
  "external_task_id": ""
}
'

import requests

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

payload = {
    "model_name": "kling-v2-5-turbo",
    "prompt": "一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺",
    "negative_prompt": "",
    "duration": "5",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "1:1",
    "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-v2-5-turbo',
    prompt: '一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺',
    negative_prompt: '',
    duration: '5',
    mode: 'pro',
    sound: 'on',
    aspect_ratio: '1:1',
    callback_url: '',
    external_task_id: ''
  })
};

fetch('https://api.powertokens.ai/kling/v1/videos/text2video', 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/text2video",
  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-v2-5-turbo',
    'prompt' => '一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺',
    'negative_prompt' => '',
    'duration' => '5',
    'mode' => 'pro',
    'sound' => 'on',
    'aspect_ratio' => '1:1',
    '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/text2video"

	payload := strings.NewReader("{\n  \"model_name\": \"kling-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\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/text2video")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"model_name\": \"kling-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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-v2-5-turbo\",\n  \"prompt\": \"一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺\",\n  \"negative_prompt\": \"\",\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"sound\": \"on\",\n  \"aspect_ratio\": \"1:1\",\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
  }
}

授权

Authorization

string

header

必填

在请求头中传入 Authorization: Bearer <token>。

请求头

Content-Type

string

默认值:application/json

必填

数据交换格式

请求体

application/json

model_name

enum<string>

必填

模型名称

可用选项:

kling-v2-5-turbo

prompt

string

必填

正向文本提示词

Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：
- 通过<<<>>>的格式来指定某个主体、图片或视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>

不能超过 2500 个字符
用 <<<voice_1>>> 来指定音色，序号同 voice_list；至多引用 2 个音色；指定音色时 sound 必须为 on；语法结构越简单越好，如：男人<<<voice_1>>>说："你好"； -voice_list 不为空且 prompt 引用音色 ID 时按「有指定音色」计费
当 multi_shot 为 false 或 shot_type 为 intelligence 时不得为空。

Maximum string length: 2500

multi_shot

boolean

默认值:false

是否生成多镜头视频。当前参数为 true 时，prompt 参数无效，且不支持设定首尾帧生视频。当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效

shot_type

enum<string>

分镜方式当 multi_shot 参数为 true 时，当前参数必填

可用选项:

customize,

intelligence

multi_prompt

object[]

各分镜信息，如提示词、时长等。通过 index、prompt、duration 参数定义分镜序号及相应提示词和时长。

最多支持 6 个分镜，最小支持 1 个分镜。
每个分镜相关内容的最大长度不超过 512。
每个分镜的时长不大于当前任务的总时长，不小于 1。
所有分镜的时长之和等于当前任务的总时长。

用key:value承载，格式如下：

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

当 multi_shot 为 true 且 shot_type 为 customize 时必填

Required array length: 1 - 6 elements

Show child attributes

negative_prompt

string

负向文本提示词

不能超过 2500 个字符
建议通过正向提示词中的负向句子补充负向提示信息

Maximum string length: 2500

sound

enum<string>

默认值:off

生成视频时是否同时生成声音

可用选项:

on,

off

cfg_scale

number

默认值:0.5

生成视频的自由度；值越大，模型的自由度越小 kling-v2.x 模型不支持此参数

必填范围: 0 <= x <= 1

mode

enum<string>

默认值:std

生成视频的模式

std：标准模式（标准），基础模式，性价比高，输出视频分辨率为720P。
pro：专家模式（高品质），高表现模式，生成视频质量更佳，输出视频分辨率为1080P。

可用选项:

std,

pro

aspect_ratio

enum<string>

默认值:16:9

生成视频帧的宽高比（宽:高）

可用选项:

1:1,

16:9,

9:16

duration

enum<string>

默认值:5

视频时长，单位秒。

可用选项:

5,

10

watermark_info

object

是否同时生成含水印的结果。

通过enabled参数定义，具体格式如下：

"watermark_info": { "enabled": boolean }

true 为生成，false 为不生成
暂不支持自定义水印

Show child attributes

callback_url

string

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

external_task_id

string

自定义任务ID。

传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。
请注意，单用户下需要保证唯一性。

响应

200 - application/json

任务已受理。

code

integer

错误码；具体定义见错误码。

message

string

错误信息。

request_id

string

请求ID，系统生成，用于跟踪请求、排查问题。

data

object

Show child attributes

Kling 文生视频 kling-v2-1-master

Kling 文生视频 kling-v3

聊天模型

图像模型

视频模型

音频模型

资产库

Kling 文生视频 kling-v2-5-turbo

授权

请求头

请求体

响应