Query Subject

GET

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

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

Query the status and result of a "Create Subject" task. Poll until CreateAigcAdvancedCustomElementTask.Status is FINISH.

Status: PROCESSING (in progress) / FINISH (complete).

ErrCode: 0 means success; non-zero means failure (see ErrCodeExt / Message).

On success the subject ID is at Output.InfoList[].ElementId (used as subject_infos.Id in video generation).

Request

Authorization

Path Params

Responses

🟢200

application/json

Query successful

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "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"
    }
}

Modified at 2026-06-23 06:58:32

Create Subject

Query Video Task