List elements

January 12, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Usage in Omni Endpoints
  6. Examples
  7. Try It

This endpoint retrieves a list of your custom elements. Elements are saved character/object references that can be reused across multiple generations in POST /images/omni and POST /videos/omni using the @element_N syntax.

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

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, the page number to retrieve. Default: 1. Must be 1 or greater.

  • pageSize is optional, the number of elements per page. Range: 1 to 100. Default: 50.

  • tag is optional, filter elements by tag. Use GET /elements/tags to get available tags.

  • official is optional, filter to show only official/system elements. Default: false.

  • favored is optional, filter to show only favored elements. Default: false.

  • sortDirection is optional, sort order for results. Supported values: ASC, DESC (default).

Responses

  • 200 OK

    {
  "elementsList": [
    {
      "id": "u_300171730302481",
      "name": "FashionLady ABC12",
      "coverImage": "https://s21-kling.klingai.com/ai-platform/.../cover.jpg",
      "description": "Elegant woman in red dress",
      "tag": {
        "id": "1",
        "tagKey": "character",
        "tagDesc": "Character"
      },
      "imageResources": [
        "https://s21-kling.klingai.com/ai-platform/.../image1.jpg",
        "https://s21-kling.klingai.com/ai-platform/.../image2.jpg"
      ],
      "favored": false,
      "official": false,
      "createTime": 1736640000000,
      "updateTime": 1736640000000
    }
  ],
  "pageNum": 1,
  "pageSize": 50,
  "total": 3
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
  elementsList: {
    id: string
    name: string
    coverImage: string
    description: string
    tag: {
      id: string
      tagKey: string
      tagDesc: string
    }
    imageResources: string[]
    favored: boolean
    official: boolean
    createTime: number
    updateTime: number
  }[]
  pageNum: number
  pageSize: number
  total: number
}
Usage in Omni Endpoints

Once you have element IDs, you can reference them in POST /images/omni and POST /videos/omni:

{
  "prompt": "Character @element_1 walking through a beautiful garden",
  "element_1": "u_300171730302481"
}
Examples 
  • curl "https://api.useapi.net/v1/kling/elements/[email protected]&pageSize=10" \
   -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/elements/?email=${email}&pageSize=10`;
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/elements/?email={email}&pageSize=10"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It