Retrieve element by ID

January 12, 2026

Table of contents

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

This endpoint retrieves details for a specific element by its ID. Use GET /elements to list all your elements and get their IDs.

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

Request Headers 
Authorization: Bearer {API token}
Path Parameters
  • elementId is required, the element ID to retrieve.
Query Parameters
  • email is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.
Responses

  • 200 OK

    {
  "element": {
    "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",
      "https://s21-kling.klingai.com/ai-platform/.../image3.jpg"
    ],
    "favored": false,
    "official": false,
    "createTime": 1736640000000,
    "updateTime": 1736640000000
  }
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 404 Not Found

    {
  "error": "<error message>"
}
Model 
{ // TypeScript, all fields are optional
  element: {
    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
  }
}
Examples 
  • curl "https://api.useapi.net/v1/kling/elements/[email protected]" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer ..."

  • const token = "API token";
const email = "Previously configured account email";
const elementId = "u_300171730302481";
const apiUrl = `https://api.useapi.net/v1/kling/elements/${elementId}?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"
elementId = "u_300171730302481"
apiUrl = f"https://api.useapi.net/v1/kling/elements/{elementId}?email={email}"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It