Retrieve available element tags
January 12, 2026 (November 16, 2026)
Table of contents
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}
API tokenis required, see Setup useapi.net for details.
Query Parameters
emailis optional. Without it, one of your accounts is used to read the list (429while every account is at itsmaxJobs).
Responses
-
{ "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" } ] } -
{ "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())