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

# Query Single Task Interface

### Request Information

* **Method**: GET
* **URL**: `https://api.superaiglobal.com/v1/queryTask/{taskUUID}/creations`

### Request Headers

| Field         | Value                   | Description                                     |
| ------------- | ----------------------- | ----------------------------------------------- |
| Content-Type  | application/json        | Data exchange format                            |
| Authorization | Bearer `{your api key}` | Replace `{your api key}` with your Bearer token |

### Path Parameters

| Parameter Name | Type   | Required | Description                    |
| -------------- | ------ | -------- | ------------------------------ |
| taskUUID       | String | Yes      | Task ID returned by createTask |

### Request Example

```bash theme={null}
curl -X GET "https://api.superaiglobal.com/v1/queryTask/f5739925-fa8f-41c8-8f33-88aeba1ed365/creations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key_here"
```

### Response Body

| Field           | Type   | Description                                                                                                                                      |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| code            | String | Status code. 200 for success. See error codes table for other values                                                                             |
| data            | Object | Response data object                                                                                                                             |
| data.taskStatus | String | Task status:<br />- queued: Task queued<br />- running: Task processing<br />- successed: Task completed successfully<br />- failed: Task failed |
| data.result     | Json   | Result information                                                                                                                               |
| message         | String | Log message                                                                                                                                      |

### Response Examples

#### Task Queued

```json theme={null}
{
    "code": "200",
    "message": "success",
    "data": {
        "taskStatus": "queued",
        "result": {}
    }
}
```

#### Task Running

```json theme={null}
{
    "code": "200",
    "message": "success",
    "data": {
        "taskStatus": "running",
        "result": {}
    }
}
```

#### Task Completed Successfully

```json theme={null}
{
    "code": "200",
    "message": "success",
    "data": {
        "taskStatus": "succeeded",
        "result": {
            "status": "successed",
            "time_used": 75,
            "video_url": "https://upload.superaiglobal.com/upload/aigc_video/24/24b65313f9f5cdda46327058e1f551f2.mp4",
            "thumb_path": "https://upload.superaiglobal.com/upload/video_thumb/20251127/56b4ba3a19d9cfa30778f6d7d64844da.jpg"
        }
    }
}
```

#### Task Failed

```json theme={null}
{
    "code": "404",
    "message": "Task not found: undefined",
    "data": null
}
```
