Retrieve Kling assets

April 18, 2025

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

This endpoint retrieves generated assets from your Kling account.

https://api.useapi.net/v1/kling/assets/?…

Request Headers
Authorization: Bearer {API token}
Query Parameters
  • email is optional when only one account configured.
    However, if you have multiple accounts configured, this parameter becomes required.

  • pageNum is optional, specify the page number to retrieve.
    Default 1.

  • pageSize is optional, specify the number of items per page.
    Default 40.

  • contentType is optional, type of content to retrieve.
    Supported values: video, image, or audio.

Responses
  • 200 OK

    {
      "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
          }
        ]
      }
    }
    
  • 400 Bad Request

    {
      "error": "Invalid parameters"
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
Model
{ // 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 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/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())
    
Try It