Retrieve uploaded Kling assets

August 8, 2025

Table of contents

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

This endpoint retrieves assets that you have uploaded to your Kling account, as opposed to generated assets.

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

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 20.

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

  • fileName is optional, filter by file name (keyword search).

Responses
  • 200 OK

    {
      "uploadAssetsList": [
        {
          "id": "1234567890",
          "name": "abcdef12345.mp4",
          "userId": 12345,
          "contentType": "video",
          "resource": {
            "resource": "https://v15-kling.klingai.com/….mp4",
            "height": 1080,
            "width": 720,
            "duration": 9040,
            "resourceKey": ""
          },
          "cover": {
            "resource": "https://v15-kling.klingai.com/…",
            "height": 1080,
            "width": 720,
            "duration": 0,
            "resourceKey": ""
          },
          "createTime": 1754630473303,
          "updateTime": 1754630473303,
          "favored": false,
          "extraInfo": "{}",
          "entrance": ""
        },
        {
          "id": "1234567890",
          "name": "abcdef12345.mp4",
          "userId": 12345,
          "contentType": "image",
          "resource": {
            "resource": "https://v15-kling.klingai.com/…",
            "height": 1080,
            "width": 720,
            "duration": 0,
            "resourceKey": ""
          },
          "cover": {
            "resource": "",
            "height": 1,
            "width": 1,
            "duration": 0,
            "resourceKey": ""
          },
          "createTime": 1754627757354,
          "updateTime": 1754627757354,
          "favored": false,
          "extraInfo": "{}",
          "entrance": ""
        }
      ]
    }
    
  • 400 Bad Request

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

    {
      "error": "Unauthorized",
      "code": 401
    }
    
Model
{ // TypeScript, all fields are optional
    uploadAssetsList: {
        id: string            // Unique asset identifier
        name: string          // Generated unique filename
        userId: number        // User ID who uploaded the asset
        contentType: string   // "video", "image", or "audio"
        resource: {
            resource: string    // URL of the uploaded asset
            height: number      // Height in pixels
            width: number       // Width in pixels  
            duration: number    // Duration in milliseconds (0 for images)
            resourceKey: string // Resource key (usually empty)
        }
        cover: {
            resource: string    // URL of cover image (empty for images)
            height: number      // Cover height (1 for images without cover)
            width: number       // Cover width (1 for images without cover)
            duration: number    // Cover duration (always 0)
            resourceKey: string // Cover resource key (usually empty)
        }
        createTime: number      // Upload timestamp
        updateTime: number      // Last update timestamp
        favored: boolean        // Whether asset is favorited
        extraInfo: string       // Extra information as JSON string
        entrance: string        // Entry point (usually empty)
    }[]
}
Examples
  • curl "https://api.useapi.net/v1/kling/assets/uploaded/?contentType=image" \
       -H "Accept: application/json" \
       -H "Authorization: Bearer …" 
    
  • const token = "API token";
    const apiUrl = `https://api.useapi.net/v1/kling/assets/uploaded/?contentType=image`; 
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    apiUrl = f"https://api.useapi.net/v1/kling/assets/uploaded/?contentType=image"
    headers = {
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers)
    print(response, response.json())
    
Try It