Retrieve element by ID
January 12, 2026 (November 16, 2026)
Table of contents
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}
API tokenis required, see Setup useapi.net for details.
Path Parameters
elementIdis required, the element ID to retrieve.
Query Parameters
emailis optional with one account. With more than one, pass theemailof the account that created the element: without it, the request goes to one of your accounts (429while every account is at itsmaxJobs) and may not find the element.
Responses
-
{ "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 } -
{ "error": "Unauthorized", "code": 401 } -
{ "error": "<error message>" }
Model
One element with its type, name, description, cover, resources, tags and assigned voice.
The element and its resources, field by field
{ // 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/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())