> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling Element Create

> Create a custom element (character, scene, prop, outfit, etc.) for use in Kling video generation.

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

<CodeGroup>
  ```bash cURL theme={null}
  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"}]
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://www.anyfast.ai/kling/v1/general/advanced-custom-elements",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "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"}]
      }
  )

  task = response.json()
  print(f"Task ID: {task['task_id']}")
  ```
</CodeGroup>

## Parameters

| Parameter                          | Type   | Required | Description                                        |
| ---------------------------------- | ------ | -------- | -------------------------------------------------- |
| `element_name`                     | string | Yes      | Name of the custom element                         |
| `element_description`              | string | Yes      | Description of the custom element                  |
| `reference_type`                   | string | Yes      | Fixed value `image_refer`                          |
| `element_image_list.frontal_image` | string | Yes      | URL of the frontal reference image                 |
| `element_image_list.refer_images`  | array  | Yes      | Additional reference images, each with `image_url` |
| `tag_list`                         | array  | Yes      | Tag list, each item with `tag_id`                  |

### Available tag\_id values

| tag\_id | Category            |
| ------- | ------------------- |
| `o_101` | 热梗                  |
| `o_102` | Character (人物)      |
| `o_103` | Animal (动物)         |
| `o_104` | Prop (道具)           |
| `o_105` | Outfit (服饰)         |
| `o_106` | Scene (场景)          |
| `o_107` | Special Effect (特效) |
| `o_108` | Other (其他)          |

## Response

The endpoint returns a `task_id` immediately. Use [Query Custom Element](/guides/model-api/kuaishou/kling-element-query) to poll until `task_status` is `succeed`.

| Field            | Description           |
| ---------------- | --------------------- |
| `id` / `task_id` | Task ID for polling   |
| `object`         | Fixed `video`         |
| `model`          | Fixed `kling-element` |
| `status`         | Initially empty       |
| `progress`       | 0–100                 |

<Card title="API Reference" icon="code" href="/api-reference/model-api/kuaishou/kling-element-create">
  View the interactive API playground for Kling Element Create.
</Card>

<script src="/feedback.js" />