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

# Qwen Image Task Query API

> Qwen Image integration guide - Ace Data Cloud

`POST https://api.acedata.cloud/qwen-image/tasks` is used to query, batch query, or delete Qwen Image asynchronous tasks. This interface does not incur additional API consumption.

## Query a Single Task

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/qwen-image/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"action":"retrieve","id":"TASK_ID"}'
```

After the task is completed, `response.data` contains the permanent CDN image address, `response.usage` contains the actual input/output quantity, and `response.cost` is the settlement information for the generated task.

## Batch Query

```json theme={null}
{
  "action": "retrieve_batch",
  "ids": [
    "TASK_ID_1",
    "TASK_ID_2"
  ]
}
```

Returns `{ "items": [...], "count": 2 }`. The list query also supports filtering by user, application, and creation time range.

## Delete Task Record

```json theme={null}
{"action":"delete","id":"TASK_ID"}
```

Deletion only affects the task history and will not delete the generated CDN files.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.