Text Generation Video

POST

https://api.cometapi.com/kling/v1/videos/text2video

Maintainer:Not configured

This document is not updated in real time, for the full version please check the official document: https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M

Request

Header Params

Authorization

string

required

Example:

Content-Type

string

optional

Example:

application/json

Body Params application/json

model_name

string

optional

Default value: kling-v1,Example values:kling-v1,kling-v1-5,kling-v1-6

prompt

string

required

Positive text alert, mandatory, can't exceed 500 characters

negative_prompt

string

optional

Negative text alert, optional, cannot exceed 200 characters

cfg_scale

number

optional

Degree of freedom of the generated video, optional, the larger the value, the stronger the correlation, value range: [0,1]

mode

enum<string>

optional

Mode of video generation, optional, enumeration value: std (high performance) or pro (high performance)

Allowed values:

stdpro

camera_control

object

optional

Protocol for controlling camera motion, optional, unspecified then smart match

type

enum<string>

optional

Enumerated values:simple,down_back,forward_up,right_turn_forward,left_turn_forward

Allowed values:

simpledown_backforward_upright_turn_forwardleft_turn_forward

config

object

optional

Contains six fields to specify camera movement or changes

aspect_ratio

string

optional

Aspect ratio of the generated image, optional, enumeration values: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

duration

string

optional

Generate video duration in seconds, optional, enumeration value: 5, 10

callback_url

string

optional

Address for callback notification of the results of this task, optional

external_task_id

string

optional

Customized Task ID
● User-defined task ID, passed in will not overwrite the system-generated task ID, but support task query by this ID
● Please note that uniqueness needs to be guaranteed under single user.

Example

{
    "prompt": "A happy scene of a vacation on the beach.",
    "image": "iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAABFFBMVEUAAAABFBYFZWoHeoMHd4MFXmsBFhoAeGUC1MYI+fsP+P8P8f8N5v8K1/8Hq9wDXHwAUDEA6KQA/80E990J9e4R9/8K1vkHyPYEsfgBk9sAKy0AkUsA/5YA/aQA+rkG+NEN+egFgvoAP/0AMf8ARv8AGFsBn0YG/3wA/YQF/aoQ/MQInv8AUP8BW/8CYf8AdS8Y+m0g/5wo/rMd5OcCTqMAEEIBJEoDadEAGC8AEwcR/WIs92FU+2xT/XpP/o1U/6ctwqMAABEFhc4Fn/YBFyQlpT5l/1+G+F6Z+2SW/4BUuG8COEcIwvpmpzzP/17c+VyIz3EGmqqkqTz//1nS+oIAACEZrpkATUkAwrbg+nSWzmECZ//nXTRpAAABDklEQVR4AbXQA0+wYRjF8XO9RjaGPGU3Ztv4mtnmEKZsDtk4PUZrXv/pbL+HN74mcW6tp8/wtwK6X35EH1G6+38n/0TpyIXhonYq+B4gApF1B8aJ3HjKqedZpCgGyrKNSYJ7+Ss7Ci0gU86A4FkTc8wvkRGo5Qtk0EQUicbd0KuQ8SvYVVXX1NTCyqMOzuobGptg9TcMbm22d0sr3LW22Lu53m1hAfZuamtwa52HvdtraqqrnMcXjPQu6JWTIDlgYSHBYajlkdR1xsTsUyCI88gg73ntwb/gEkxEx0oCsMKg6X8e/K8o12BjLN9EXm+v8Z+KkIdwIMKodEfyP5Uu4ELA2/qUR8BEu1/U/at7B7OBbYeTZaCnAAAAAElFTkSuQmCC"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cometapi.com/kling/v1/videos/text2video' \
--header 'Authorization: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A happy scene of a vacation on the beach.",
    "image": "iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAABFFBMVEUAAAABFBYFZWoHeoMHd4MFXmsBFhoAeGUC1MYI+fsP+P8P8f8N5v8K1/8Hq9wDXHwAUDEA6KQA/80E990J9e4R9/8K1vkHyPYEsfgBk9sAKy0AkUsA/5YA/aQA+rkG+NEN+egFgvoAP/0AMf8ARv8AGFsBn0YG/3wA/YQF/aoQ/MQInv8AUP8BW/8CYf8AdS8Y+m0g/5wo/rMd5OcCTqMAEEIBJEoDadEAGC8AEwcR/WIs92FU+2xT/XpP/o1U/6ctwqMAABEFhc4Fn/YBFyQlpT5l/1+G+F6Z+2SW/4BUuG8COEcIwvpmpzzP/17c+VyIz3EGmqqkqTz//1nS+oIAACEZrpkATUkAwrbg+nSWzmECZ//nXTRpAAABDklEQVR4AbXQA0+wYRjF8XO9RjaGPGU3Ztv4mtnmEKZsDtk4PUZrXv/pbL+HN74mcW6tp8/wtwK6X35EH1G6+38n/0TpyIXhonYq+B4gApF1B8aJ3HjKqedZpCgGyrKNSYJ7+Ss7Ci0gU86A4FkTc8wvkRGo5Qtk0EQUicbd0KuQ8SvYVVXX1NTCyqMOzuobGptg9TcMbm22d0sr3LW22Lu53m1hAfZuamtwa52HvdtraqqrnMcXjPQu6JWTIDlgYSHBYajlkdR1xsTsUyCI88gg73ntwb/gEkxEx0oCsMKg6X8e/K8o12BjLN9EXm+v8Z+KkIdwIMKodEfyP5Uu4ELA2/qUR8BEu1/U/at7B7OBbYeTZaCnAAAAAElFTkSuQmCC"
}'

Responses

🟢200Successful Response

application/json

Body

code

integer

optional

Error code; specifically define the error code

message

string

optional

error message

request_id

string

optional

Request ID, system-generated, for tracking requests, troubleshooting issues

data

object

optional

task_id

string

optional

Task ID, system generated

task_status

string

optional

Task status, enumerated values: submitted, processing, succeed, failed.

created_at

integer

optional

Task creation time, Unix timestamp, in ms.

updated_at

integer

optional

Task update time, Unix timestamp, in ms.

Example

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}

Generating images

Image Generation Video