Skip to main content
Custom elements let you bind your own reference images to a reusable element ID that can be referenced in Kling video generation. The creation is asynchronous — poll the query endpoint until task_status is succeed.

​
Key capabilities

  • Character & Scene Elements — Upload frontal + side images to build a reusable character or background
  • Multiple Categories — Characters, animals, props, outfits, scenes, special effects
  • Async Processing — Creation is handled as a background task; use the task_id to poll status

​
Quick example

curl https://www.anyfast.ai/kling/v1/general/advanced-custom-elements \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "element_name": "my-character",
    "element_description": "A protagonist character for my 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"}]
  }'

​
Parameters

ParameterTypeRequiredDescription
element_namestringYesName of the custom element
element_descriptionstringYesDescription of the custom element
reference_typestringYesFixed value image_refer
element_image_list.frontal_imagestringYesURL of the frontal reference image
element_image_list.refer_imagesarrayYesAdditional reference images, each with image_url
tag_listarrayYesTag list, each item with tag_id

​
Available tag_id values

tag_idCategory
o_101热梗
o_102Character (人物)
o_103Animal (动物)
o_104Prop (道具)
o_105Outfit (服饰)
o_106Scene (场景)
o_107Special Effect (特效)
o_108Other (其他)

​
Response

The endpoint returns a task_id immediately. Use Query Custom Element to poll until task_status is succeed.
FieldDescription
id / task_idTask ID for polling
objectFixed video
modelFixed kling-element
statusInitially empty
progress0–100

API Reference

View the interactive API playground for Kling Element Create.