Retrieve available element tags

January 12, 2026 (October 20, 2026)

Table of contents

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

This endpoint retrieves available element category tags. Tags are used to categorize elements when creating them via POST /elements and for filtering when listing elements via GET /elements.

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

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • email is optional. Without it, one of your accounts is used to read the list (429 while every account is at its maxJobs).
Responses

  • 200 OK

    {
  "tagList": [
    {
      "id": "o_102",
      "tagKey": "character",
      "name": "Characters",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_103",
      "tagKey": "animal",
      "name": "Animals",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_104",
      "tagKey": "prop",
      "name": "Items",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_105",
      "tagKey": "costume",
      "name": "Costumes",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_106",
      "tagKey": "scene",
      "name": "Scenes",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_107",
      "tagKey": "effect",
      "name": "Effects",
      "official": true,
      "type": "element"
    },
    {
      "id": "o_108",
      "tagKey": "others",
      "name": "Others",
      "official": true,
      "type": "element"
    }
  ]
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
  tagList: {
    id: string
    tagKey: string
    name: string
    official: boolean
    type: string
  }[]
}
Examples 
  • curl "https://api.useapi.net/v1/kling/elements/tags/[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/elements/tags/?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/elements/tags/?email={email}"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It