Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
Generate video from text using kling-2.6/text-to-video
curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "kling-2.6/text-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Scene: A fashion live-streaming sales setting, with clothes hanging on racks and the host's figure reflected in a full-length mirror. Lines: [African female host] turns around to showcase the hoodie's cut. [African female host, in a cheerful tone] says: \"360-degree flawless tailoring, slimming and versatile.\" She then [African female host] leans closer to the camera. [African female host, in a lively tone] says: \"Double-sided fleece fabric, $30 off immediately when you order now.\"",
    "sound": false,
    "aspect_ratio": "1:1",
    "duration": "5"
  }
}
EOF
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_kling-2.6_1765182425861"
  }
}

​
Query Task Status

After submitting a task, you can check the task progress and retrieve generation results via the unified query endpoint:

Get Task Details

Learn how to query task status and obtain generation results
In production environments, it is recommended to use the callBackUrl parameter to receive automatic notifications upon generation completion, rather than polling the status endpoint.

Market Overview

Browse all available models

Common API

Check account credits and usage status

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Obtaining an API Key:

  1. Visit the API Key Management Page to get your API Key

Usage Method: Add the following to the request header: Authorization: Bearer YOUR_API_KEY

Notes:

  • Keep your API Key secure and do not disclose it to others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json
​
model
enum<string>
default:kling-2.6/text-to-video
required

Name of the model used for the generation task. Required field.

  • This endpoint must use the kling-2.6/text-to-video model
Available options:
kling-2.6/text-to-video
Example:

"kling-2.6/text-to-video"

​
callBackUrl
string<uri>

Callback URL to receive notifications when the generation task is completed. Optional configuration, recommended for production environments.

  • After the task is completed, the system will POST the task status and results to this URL
  • The callback content includes the generated resource URL and task-related information
  • Your callback endpoint must support receiving POST requests with JSON payloads
  • You can also choose to call the task details endpoint to actively poll the task status
  • To ensure callback security, see Webhook Verification Guide for signature verification implementation
Example:

"https://your-domain.com/api/callback"

​
input
object

Input parameters for the generation task

Response

Request Successful

​
code
enum<integer>

Response Status Code

  • 200: Success - Request processed successfully
  • 401: Unauthorized - Authentication credentials missing or invalid
  • 402: Insufficient Credits - Account has insufficient credits to perform the operation
  • 404: Not Found - The requested resource or endpoint does not exist
  • 422: Validation Error - Request parameters failed validation
  • 429: Rate Limit Exceeded - Exceeded the request frequency limit for the resource
  • 455: Service Unavailable - System is under maintenance
  • 500: Server Error - Unexpected failure occurred while processing the request
  • 501: Generation Failed - Content generation task execution failed
  • 505: Function Disabled - The requested function is temporarily unavailable
Available options:
200,
401,
402,
404,
422,
429,
455,
500,
501,
505
​
msg
string

Response message; error description if the request fails

Example:

"success"

​
data
object