Qwen Image 2 Pro API, Qwen Image Edit API, Qwen Image API - AI Image Generation & Editing APIs

Authentication

All requests require an API key passed via header.

Webhook (Optional)

Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.

X-Webhook-URL: https://your-server.com/webhook/callback

Request Parameters - Qwen Image Max Edit generate request

Response

{
  "request_id": "qwen-image-max-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/qwen-image-max-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Response Handling

Common status codes for Qwen Image Max Edit generate request.

Notes & Tips

1. Poll the results endpoint every 2–3 seconds until status is COMPLETED or FAILED
2. Implement exponential backoff for retry logic on 500 or 429 responses
3. Use clear, specific prompts that describe the desired change in context, lighting, or environment
4. Avoid overly vague prompts like “make it better”; specify elements such as “replace sky with sunset”
5. Validate image URLs are publicly accessible and use HTTPS before submission
6. Limit num_images to 1 unless multiple variations are required to

   Response Handling

   Common status codes.

   Code	Meaning
   202	Accepted — Request queued
   400	Bad Request
   401	Unauthorized
   402	Insufficient Balance
   403	Forbidden
   429	Too Many Requests
   500	Internal Server Error

   Error Responses

   Queue system errors and model validation errors.

   Queue System Errors

   // 402 — Insufficient balance
   {
     "error": "Insufficient Balance",
     "message": "Your wallet does not have enough balance."
   }

   // 400 — Model not found
   {
     "error": "Model not found",
     "message": "Model 'qwen-image-max-edit' not found or is disabled"
   }

   Error via Status/Webhook

   {
     "request_id": "qwen-image-max-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
     "status": "ERROR",
     "model_id": "qwen-image-max-edit",
     "error": "Description of the error",
     "output": null
   }

   Retrieving Results

   Poll the universal status endpoint to check progress and retrieve results.

   Endpoint

   GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
   Ocp-Apim-Subscription-Key: YOUR_API_KEY

   cURL Example

   curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
     "https://gateway.pixazo.ai/v2/requests/status/qwen-image-max-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

   Response (Completed)

   {
     "request_id": "qwen-image-max-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
     "status": "COMPLETED",
     "model_id": "qwen-image-max-edit",
     "error": null,
     "output": {
       "media_url": [
         "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/qwen-image-max-edit_019dxxxx-xxxx/output.ext"
       ],
       "media_type": "application/octet-stream"
     },
     "created_at": "2026-03-31T10:00:00.000Z",
     "updated_at": "2026-03-31T10:00:15.000Z",
     "completed_at": "2026-03-31T10:00:15.000Z"
   }

   Response Fields

   Field	Type	Description
   request_id	string	Unique request identifier
   status	string	QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
   model_id	string	Model that processed the request
   error	string|null	Error message if failed
   output.media_url	array	URLs to generated media (R2 CDN)
   output.media_type	string	MIME type of the output
   created_at	string	When request was created
   completed_at	string|null	When request completed
   polling_url	string	Status URL (initial response only)

   Status Values

   Status	Description
   QUEUED	Request accepted, waiting to be processed
   PROCESSING	Being processed by the model
   COMPLETED	Done — output contains the result
   FAILED	Failed — check error field
   ERROR	System error — not charged

   Status Flow

   QUEUED → PROCESSING → COMPLETED
                       → FAILED
                       → ERROR

   Typical Workflow

   1. Send a generate request to the API endpoint
   2. Save the request_id from the response
   3. Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
   4. When status is "COMPLETED", download from output.media_url

   Tip: Use X-Webhook-URL header to get a callback instead of polling.