Retrieve element by ID

January 12, 2026 (February 9, 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

    {
  "id": "u_123456789012345",
  "name": "FashionLady ABC12",
  "userId": 12345678,
  "type": "IMAGE",
  "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
  id: string
  name: string
  userId: number
  type: 'IMAGE' | 'VIDEO'
  description: string
  cover: {
    resource: string
    width: number
    height: number
    resourceKey: 'cover' | 'secondary' | 'video'
    cover: boolean
    slotKey: string
  }
  resources: {
    resource: string
    width: number
    height: number
    resourceKey: 'cover' | 'secondary' | 'video'
    cover: boolean
    slotKey: string
    voice: {
      id: number
      name: string
      official: boolean
      resource: object
    }
  }[]
  tagList: object[]
  voice: {
    id: number
    name: string
    official: boolean
    resource: object
  }
  currentVersion: number
  createTime: number
  updateTime: number
  favored: boolean
  official: boolean
}
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_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