Skip to main content
GET
/
vendors
/
alibaba
/
v1
/
qwen-image-edit-max
/
generation
/
{task_id}
Get Generation Task
curl --request GET \
  --url https://api.mulerouter.ai/vendors/alibaba/v1/qwen-image-edit-max/generation/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "completed",
    "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

StatusDescription
pendingTask is waiting to be processed
processingTask is currently being processed
completedTask completed successfully
failedTask 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

Task result

​
task_info
object
​
images
string<uri>[]

Generated image URLs (only present when status is success)

URL of the generated image (valid for 24 hours)