创建自定义元素

POST

/v1/general/advanced-custom-elements

最后修改时间：2026-11-04 13:11:00

异步创建元素；成功后从 data.task_result.elements[0].element_id 获取元素 ID。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "element_name": "string",
    "element_description": "string",
    "reference_type": "image_refer",
    "element_image_list": {
        "frontal_image": "string",
        "refer_images": [
            {
                "image_url": "string"
            }
        ]
    },
    "element_video_list": {
        "refer_videos": [
            {
                "video_url": "string"
            }
        ]
    },
    "element_voice_id": "string",
    "callback_url": "http://example.com",
    "external_task_id": "string",
    "tag_list": [
        {
            "tag_id": "string"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/general/advanced-custom-elements' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "element_name": "string",
    "element_description": "string",
    "reference_type": "image_refer",
    "element_image_list": {
        "frontal_image": "string",
        "refer_images": [
            {
                "image_url": "string"
            }
        ]
    },
    "element_video_list": {
        "refer_videos": [
            {
                "video_url": "string"
            }
        ]
    },
    "element_voice_id": "string",
    "callback_url": "http://example.com",
    "external_task_id": "string",
    "tag_list": [
        {
            "tag_id": "string"
        }
    ]
}'

返回响应

🟢200

application/json

请求已提交（异步任务）

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "submitted",
        "task_status_msg": "string",
        "task_info": {
            "external_task_id": "string"
        },
        "task_result": {}
    }
}

🟠400

🟠401

修改于 2026-11-04 13:11:00

grok-imagine-image （图像编辑）统一格式 Copy

分页查询自定义元素