Skip to main content
POST
/
kling
/
v1
/
general
/
advanced-custom-elements
Create Custom Element
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/general/advanced-custom-elements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
    }
  ]
}
'
{
  "id": "863121016086724692",
  "task_id": "863121016086724692",
  "object": "video",
  "model": "kling-element",
  "status": "",
  "progress": 0,
  "created_at": 1773812605
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
element_name
string
required

Name of the custom element.

Example:

"my-character"

​
element_description
string
required

Description of the custom element.

Example:

"A protagonist character for my video series"

​
reference_type
enum<string>
required

Reference type. Currently fixed to image_refer.

Available options:
image_refer
Example:

"image_refer"

​
element_image_list
object
required
​
tag_list
object[]
required

Tag list. Available tag_id values:

  • o_101: 热梗
  • o_102: 人物 (Character)
  • o_103: 动物
  • o_104: 道具
  • o_105: 服饰
  • o_106: 场景 (Scene)
  • o_107: 特效
  • o_108: 其他

Response

Element creation task submitted

​
id
string

Task ID

Example:

"863121016086724692"

​
task_id
string

Task ID (same as id)

Example:

"863121016086724692"

​
object
string

Fixed value video

Example:

"video"

​
model
string

Fixed value kling-element

Example:

"kling-element"

​
status
string

Initial status (empty)

Example:

""

​
progress
integer

Progress 0–100

Example:

0

​
created_at
integer

Unix timestamp

Example:

1773812605