Skip to main content
Custom elements allow you to bind reference images to a reusable element ID for referencing in Kling video generation. Creation is an asynchronous task — after submitting, poll the query endpoint until task_status is succeed.

​
Key Capabilities

  • Character and scene elements — Upload front + side images to build reusable characters or backgrounds
  • Multiple categories — Supports character, animal, prop, clothing, scene, special effect, and more
  • Asynchronous processing — Creation runs in the background; use task_id to poll status

​
Quick Example

curl https://ai.alad.com/kling/v1/general/advanced-custom-elements \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "element_name": "my-character",
    "element_description": "Main character in the video series",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/frontal.jpg",
      "refer_images": [
        {"image_url": "https://example.com/side.jpg"}
      ]
    },
    "tag_list": [{"tag_id": "o_102"}]
  }'

​
Request Parameters

ParameterTypeRequiredDescription
element_namestring✅Element name
element_descriptionstring✅Element description
reference_typestring✅Fixed value image_refer
element_image_list.frontal_imagestring✅Front-facing reference image URL
element_image_list.refer_imagesarray✅Array of additional reference images, each with image_url
tag_listarray✅Tag list, each item contains tag_id

​
Available tag_id Values

tag_idTag Name
o_101Trending
o_102Character
o_103Animal
o_104Prop
o_105Clothing
o_106Scene
o_107Special Effect
o_108Other

​
Response

The endpoint immediately returns a task_id. Use query custom element to poll until task_status is succeed.
FieldDescription
id / task_idTask ID
objectFixed video
modelFixed kling-element
statusInitially empty
progressProgress 0–100

API Reference

View the interactive API documentation for Kling Create Custom Element.