Overview
Generate and edit images with Qwen Image models using text prompts and optional reference images.
Primary Endpoint
POST
/api/v1/userQwen2Image/startStart a new Qwen2 image generation/edit task
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Task name |
| prompt | string | Yes | Image generation or editing prompt |
| model | enum: qwen-image-2.0 | qwen-image-2.0-pro | qwen-image-3.0 | qwen-image-3.0-pro | No | - |
| input_images | array<string> | No | Optional public reference image URLs |
| size | enum: 1024*1024 | 1328*880 | 880*1328 | 1152*864 | 864*1152 | 1280*720 | 720*1280 | 1512*648 | 2048*2048 | 2048*1365 | 1365*2048 | 2048*1536 | 1536*2048 | 2048*1152 | 1152*2048 | No | 1K sizes are supported by all Qwen Image models. 2K sizes (2048*) are supported only by qwen-image-3.0-pro. |
| webhook_url | string | No | HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth. |
| webhook_token | string | No | Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e. |
Request Example
curl -X POST "https://www.a2e.com.cn/api/v1/userQwen2Image/start" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My generation task",
"prompt": "A cinematic scene with natural motion",
"model": "qwen-image-2.0",
"input_images": [],
"size": "1024*1024",
"webhook_url": "https://your-server.example.com/a2e/webhook",
"webhook_token": "a-shared-secret"
}'Related Endpoints
POST
/api/v1/userQwen2Image/startStart a new Qwen2 image generation/edit task
GET
/api/v1/userQwen2Image/listList Qwen2 image tasks
GET
/api/v1/userQwen2Image/detail/{id}Get Qwen2 image task details
POST
/api/v1/userQwen2Image/batchDetailBatch get Qwen2 image task details
DELETE
/api/v1/userQwen2Image/{id}Delete a Qwen2 image task
Responses
200
Task created successfully
401
Unauthorized - Invalid or missing bearer token