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_123456789012345",
    "name": "FashionLady ABC12",
    "userId": 12345678,
    "description": "Elegant woman in red dress",
    "cover": {
      "resource": "https://s21-kling.klingai.com/ai-platform/.../cover.jpg",
      "width": 768,
      "height": 1365,
      "resourceKey": "cover",
      "cover": true,
      "slotKey": ""
    },
    "resources": [
      { "resource": ".../cover.jpg", "resourceKey": "cover", "cover": true, "slotKey": "" },
      { "resource": ".../side.png", "resourceKey": "secondary", "cover": false, "slotKey": "side" },
      { "resource": ".../back.png", "resourceKey": "secondary", "cover": false, "slotKey": "back" },
      { "resource": ".../top.png", "resourceKey": "secondary", "cover": false, "slotKey": "topView" }
    ],
    "tagList": [],
    "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
    userId: number
    description: string
    cover: {
      resource: string
      width: number
      height: number
      resourceKey: string
      cover: boolean
      slotKey: string
    }
    resources: {
      resource: string
      width: number
      height: number
      resourceKey: string
      cover: boolean
      slotKey: string
    }[]
    tagList: object[]
    createTime: number
    updateTime: number
    favored: boolean
    official: boolean
  }
}
Examples 
  • curl "https://api.useapi.net/v1/kling/elements/u_123456789012345?email=user@example.com" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer ..."

  • const token = "API token";
const email = "Previously configured account email";
const elementId = "u_123456789012345";
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_123456789012345"
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