Qwen Image Edit Max Task

Retrieve the status and result of a generation task

GET /vendors/alibaba/v1/qwen-image-edit-max/generation/{task_id}

Get Generation Task

cURL

curl --request GET \
  --url https://api.mulerouter.ai/vendors/alibaba/v1/qwen-image-edit-max/generation/{task_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "images": [
    "<string>"
  ]
}

Overview

Retrieve the status and result of a qwen-image-edit-max generation task.

Task Status

Status	Description
pending	Task is waiting to be processed
processing	Task is currently being processed
completed	Task completed successfully
failed	Task failed with an error

Response

When the task is completed, the response will include the generated/edited image URLs in the images array. Each URL is valid for 24 hours.

Example Responses

Completed Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "completed",
    "created_at": "2025-02-09T10:30:00Z",
    "updated_at": "2025-02-09T10:30:45Z"
  },
  "images": [
    "https://example.com/edited-image-1.jpg",
    "https://example.com/edited-image-2.jpg"
  ]
}

Pending Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "pending",
    "created_at": "2025-02-09T10:30:00Z",
    "updated_at": "2025-02-09T10:30:00Z"
  }
}

Processing Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "processing",
    "created_at": "2025-02-09T10:30:00Z",
    "updated_at": "2025-02-09T10:30:15Z"
  }
}

Failed Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "failed",
    "created_at": "2025-02-09T10:30:00Z",
    "updated_at": "2025-02-09T10:30:15Z",
    "error": {
      "code": 3001,
      "title": "Invalid Request",
      "detail": "The prompt contains prohibited content"
    }
  }
}

Polling Guidelines

For asynchronous task processing:

1. Initial Wait: Wait at least 2-3 seconds before the first poll
2. Poll Interval: Poll every 2-3 seconds for pending or processing status
3. Timeout: Consider implementing a timeout (e.g., 5 minutes) for long-running tasks
4. Exponential Backoff: Consider increasing poll intervals for longer tasks

Error Handling

If the task fails, check the error object in task_info for details:

• code: Numeric error code identifying the error type
• title: Brief error description
• detail: Detailed explanation of what went wrong

Common error scenarios:

• Invalid or prohibited content in prompt
• Image file size exceeds limit
• Unsupported image format
• Invalid resolution parameters

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

task_id · string<uuid> · required

Response

200

application/json

Task result

task_info · object

Show child attributes

images · string<uri>[]

Generated image URLs (only present when status is success)

URL of the generated image (valid for 24 hours)