Retrieve available element tags

January 12, 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 when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.
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