> ## 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 API guide - Ace Data Cloud

`POST https://api.acedata.cloud/qwen-image/tasks` è utilizzato per interrogare, interrogare in batch o eliminare i compiti asincroni di Qwen Image. Questa interfaccia non genera un consumo API aggiuntivo.

## Interrogare un singolo compito

```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"}'
```

Dopo il completamento del compito, `response.data` contiene l'indirizzo dell'immagine CDN permanente, `response.usage` contiene il numero reale di input/output, e `response.cost` è le informazioni di fatturazione per il compito generato.

## Interrogazione in batch

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

Restituisce `{ "items": [...], "count": 2 }`. L'interrogazione della lista supporta anche il filtraggio per utente, applicazione e intervallo di tempo di creazione.

## Eliminare la registrazione del compito

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

L'eliminazione influisce solo sulla cronologia dei compiti, non eliminerà i file CDN già generati.


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