Retrieve available element tags

January 12, 2026 (November 16, 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

A list of element category tags in tagList, each with its id, tagKey and name.

The list of element tags, field by field
{ // 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=user@example.com" \
       -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