Retrieve Kling tasks
April 18, 2025
Table of contents
This endpoint retrieves a list of tasks from your Kling account.
https://api.useapi.net/v1/kling/tasks/?…
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Query Parameters
-
emailis optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required. -
contentTypeis optional, filter tasks by content type. Supported values:video,image, oraudio. -
pageSizeis optional, specify the number of tasks to return. -
createdBeforeis optional, timestamp (in milliseconds) to get tasks created before this time. Cannot be used withcreatedAfter. -
createdAfteris optional, timestamp (in milliseconds) to get tasks created after this time. Cannot be used withcreatedBefore.
Responses
-
{ "history": [ { "works": [ { "workId": 123456789, "workItemId": 0, "taskId": 123456789, "userId": 12345, "type": "m2v_img2video_hq", "status": 99, "status_name": "succeed", "status_final": true "contentType": "video", "resource": { "resource": "https://s21-kling.klingai.com/....mp4", "height": 1268, "width": 724, "duration": 5041, "resourceKey": "" }, "cover": { "resource": "https://s21-kling.klingai.com/....jpg", "height": 1268, "width": 724, "duration": 0, "resourceKey": "" }, "starNum": 0, "cloneCount": 0, "reportNum": 0, "createTime": 1744858514515, "taskInfo": { "type": "m2v_img2video_hq", "inputs": [ { "name": "input", "inputType": "URL", "token": null, "blobStorage": null, "url": "https://s21-kling.klingai.com/....jpg", "cover": null, "fromWorkId": null, "fromUploadId": null } ], "arguments": [ { "name": "prompt", "value": "A person dancing" }, { "name": "negative_prompt", "value": "" }, { "name": "duration", "value": "5" }, { "name": "kling_version", "value": "2.0" } ], "extraArgs": {}, "callbackPayloads": [], "scene": "NORMAL_CREATION" }, "selfAttitude": "unknown", "selfComment": { "rate": 0, "tags": [], "content": "", "prompts": [] }, "favored": false, "starred": false, "publishStatus": "unpublished", "deleted": false, "publishTime": 0, "submitTime": 1744858514515, "lipSyncStatus": 99, "downloadInfo": { "fileTypes": [ { "type": "MP4", "watermark": true } ] }, "allowPublish": true } ], "task": { "id": 123456789, "userId": 12345, "type": "m2v_img2video_hq", "scene": "NORMAL_CREATION", "status": 99, "status_name": "succeed", "status_final": true "taskInfo": { "type": "m2v_img2video_hq", "inputs": [ { "name": "input", "inputType": "URL", "token": null, "blobStorage": null, "url": "https://s21-kling.klingai.com/....jpg", "cover": null, "fromWorkId": null, "fromUploadId": null } ], "arguments": [ { "name": "prompt", "value": "A person dancing" }, { "name": "negative_prompt", "value": "" }, { "name": "duration", "value": "5" }, { "name": "kling_version", "value": "2.0" } ], "extraArgs": {}, "callbackPayloads": [], "scene": "NORMAL_CREATION" }, "favored": false, "deleted": false, "viewed": true, "createTime": 1744858514499, "updateTime": 1744858823172, "viewTime": 1744916388016 }, "etaTime": 0, "etaTimeOverSla": false, "queuingEtaTime": 0, "originEtaTime": 0, "originQueuingEtaTime": 0, "currentTimestamp": 1744955215247 } ], "userPoints": { "total": 190500 }, "userTickets": { "ticket": [ { "orderId": "123456789", "type": "priority", "packageType": "reward", "amount": 1, "balance": 1, "startTime": 1744046060883, "endTime": 1746724460883 } ] } } -
{ "error": "createdAfter and createdBefore cannot be used together" } -
{ "error": "Unauthorized", "code": 401 }
Model
List of known status values:
| status | status_name | status_final | Notes |
|---|---|---|---|
| 5 | submitted | false | |
| 6 | failed | true | |
| 7 | failed | true | The input prompt contains sensitive words |
| 9 | failed | true | Change the input prompt and try again |
| 10 | processing | false | |
| 50 | failed | true | Change the input prompt and try again |
| 99 | succeed | true |
{ // TypeScript, all fields are optional
history: {
works: {
workId: number
workItemId: number
taskId: number
userId: number
type: string
status: number
status_name: string
status_final: boolean
contentType: string
resource: {
resource: string
height: number
width: number
duration: number
resourceKey: string
}
cover: {
resource: string
height: number
width: number
duration: number
resourceKey: string
}
starNum: number
cloneCount: number
reportNum: number
createTime: number
taskInfo: {
type: string
inputs: {
name: string
inputType: string
token: string | null
blobStorage: string | null
url: string
cover: string | null
fromWorkId: number | null
fromUploadId: number | null
}[]
arguments: {
name: string
value: string
}[]
extraArgs: Record<string, any>
callbackPayloads: any[]
scene: string
}
selfAttitude: string
selfComment: {
rate: number
tags: any[]
content: string
prompts: any[]
}
favored: boolean
starred: boolean
publishStatus: string
deleted: boolean
publishTime: number
submitTime: number
lipSyncStatus: number
downloadInfo: {
fileTypes: {
type: string
watermark: boolean
}[]
}
allowPublish: boolean
}[]
task: {
id: number
userId: number
type: string
scene: string
status: number
status_name: string
status_final: boolean
taskInfo: {
type: string
inputs: {
name: string
inputType: string
token: string | null
blobStorage: string | null
url: string
cover: string | null
fromWorkId: number | null
fromUploadId: number | null
}[]
arguments: {
name: string
value: string
}[]
extraArgs: Record<string, any>
callbackPayloads: any[]
scene: string
}
favored: boolean
deleted: boolean
viewed: boolean
createTime: number
updateTime: number
viewTime: number
}
etaTime: number
etaTimeOverSla: boolean
queuingEtaTime: number
originEtaTime: number
originQueuingEtaTime: number
currentTimestamp: number
}[]
userPoints: {
total: number
}
userTickets: {
ticket: {
orderId: string
type: string
packageType: string
amount: number
balance: number
startTime: number
endTime: number
}[]
}
}
Examples
-
curl "https://api.useapi.net/v1/kling/tasks/[email protected]" \ -H "Accept: application/json" \ -H "Authorization: Bearer …" -
const token = "API token"; const email = "Previously configured account email"; const apiUrl = `https://api.useapi.net/v1/kling/tasks/?email=${email}`; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result}); -
import requests token = "API token" email = "Previously configured account email" apiUrl = f"https://api.useapi.net/v1/kling/tasks/?email={email}" headers = { "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())