查询主体

GET

https://api.tokenhot.ai/v1/general/advanced-custom-elements/{task_id}

实际请求地址: GET https://api.tokenhot.ai/v1/general/advanced-custom-elements/{task_id}

查询「创建主体」任务的状态与结果。轮询直到 CreateAigcAdvancedCustomElementTask.Status 为 FINISH。

Status: PROCESSING(处理中) / FINISH(完成)。

ErrCode: 0 表示成功;非 0 表示失败(见 ErrCodeExt / Message)。

成功后主体 ID 在 Output.InfoList[].ElementId(用于视频生成的 subject_infos.Id)。

Request

Authorization

Path Params

Responses

🟢200

application/json

查询成功

Bodyapplication/json

🟠400

🟠401

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tokenhot.ai/v1/general/advanced-custom-elements/1500062068-CreateAigcAdvancedCustomElement-7671dd6d88b91859db70653ac3b06400t'

Response Example

200 - 成功示例

{
    "Response": {
        "TaskType": "CreateAigcAdvancedCustomElement",
        "Status": "FINISH",
        "CreateTime": "2026-06-11T04:44:34Z",
        "FinishTime": "2026-06-11T04:44:35Z",
        "CreateAigcAdvancedCustomElementTask": {
            "TaskId": "1500062068-CreateAigcAdvancedCustomElement-79a1f2bd1154b1ec28c115fff474420ct",
            "Status": "FINISH",
            "ErrCode": 0,
            "ErrCodeExt": "",
            "Message": "",
            "Progress": 100,
            "Input": {
                "ElementName": "hero",
                "ElementDescription": "a young hero character",
                "ReferenceType": "image_refer"
            },
            "Output": {
                "InfoList": [
                    {
                        "ElementId": "313124644703203",
                        "ElementInfo": "{\"element_id\":313124644703203,\"element_name\":\"hero\",\"element_type\":\"image_refer\",\"status\":\"succeed\"}"
                    }
                ]
            },
            "SessionId": "unique_session_002"
        },
        "RequestId": "e8a8a30f-b8b3-4233-9c48-bd10a3fa21ba"
    }
}

创建主体

查询视频任务