Retrieve Kling assets
April 18, 2025 (November 16, 2026)
Table of contents
This endpoint retrieves generated assets from your Kling account.
https://api.useapi.net/v1/kling/assets/?…
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. -
pageNumis optional, specify the page number to retrieve.
Default1. -
pageSizeis optional, specify the number of items per page.
Default40. -
contentTypeis optional, type of content to retrieve.
Supported values:video,image, oraudio. -
sortis optional, sort direction by creation time.
Supported values:asc,desc. Defaultdesc.
Responses
-
{ "limitations": [ { "type": "mmu_txt2img_aiweb", "remaining": 10000, "limit": 10000 }, { "type": "m2v_txt2video_hq", "remaining": 10000, "limit": 10000 }, { "type": "m2v_img2video_hq", "remaining": 10000, "limit": 10000 } ], "history": [ { "works": [ { "workId": 123456789, "workItemId": 0, "taskId": 123456789, "userId": 12345, "type": "m2v_img2video_hq", "status": 99, "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, "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": { "points": [ { "orderId": "123456789", "type": "plan", "amount": 300000, "balance": 190500, "startTime": 1744081611119, "endTime": 1746760011119 } ], "total": 190500 }, "userTickets": { "ticket": [ { "orderId": "123456789", "type": "priority", "packageType": "reward", "amount": 1, "balance": 1, "startTime": 1744046060883, "endTime": 1746724460883 }, { "orderId": "123456789", "type": "extend", "packageType": "reward", "amount": 2, "balance": 2, "startTime": 1744046060883, "endTime": 1746724460883 }, { "orderId": "123456789", "type": "hq_5s", "packageType": "reward", "amount": 3, "balance": 3, "startTime": 1744046060883, "endTime": 1746724460883 } ] } } -
{ "error": "Invalid parameters" } -
{ "error": "Unauthorized", "code": 401 }
Model
Your generated videos and images (works), grouped by task in history, with the account’s limits and balance.
The generated works by task, with limits and balance, field by field
To download assets without watermarks, use the GET /assets/download endpoint with the workId values found in the works array of the response.
{ // TypeScript, all fields are optional
limitations: {
type: string
remaining: number
limit: number
}[]
history: {
works: {
workId: number
workItemId: number
taskId: number
userId: number
type: string
status: number
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
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: {
points: {
orderId: string
type: string
amount: number
balance: number
startTime: number
endTime: number
}[]
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/assets/?email=user@example.com" \ -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/assets/?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/assets/?email={email}" headers = { "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())