# Qwen Image 3.0 Image Task Status

> Image Generation

Query the execution status, result URLs, and usage details of an asynchronous image task.

## Endpoint

`GET https://api.modelverse.cn/v1/tasks/status`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| task_id | query | string | Yes | Asynchronous task identifier returned by `/v1/tasks/submit`. |

## Responses

- **200** — Task status response.
- **400** — Invalid task identifier or task status error.
- **default** — Error response.

## OpenAPI Definition

```json
{
  "openapi": "3.1.0",
  "x-language": "en-US",
  "info": {
    "title": "ModelVerse Qwen Image 3.0 API",
    "version": "1.0.0",
    "description": "Self-contained OpenAPI 3.1 schema for the ModelVerse `qwen-image-3.0`\nand `qwen-image-3.0-pro` image generation and editing APIs.\n\nThe document covers the synchronous OpenAI-compatible image generation\nroute and the asynchronous task submit/status routes for both\ntext-to-image (T2I) and image-to-image (I2I) use cases.\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "ModelVerse API endpoint documented for this model."
    }
  ],
  "tags": [
    {
      "name": "qwen  image 3.0",
      "description": "Synchronous and asynchronous image generation operations for qwen-image-3.0 and qwen-image-3.0-pro."
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/images/generations": {
      "post": {
        "tags": [
          "qwen image 3.0"
        ],
        "operationId": "createQwenImage30Generation",
        "summary": "Qwen Image 3.0 Image Generation",
        "description": "Generate or edit images synchronously with `qwen-image-3.0` or\n`qwen-image-3.0-pro`.\n\nAt least one of `prompt`, `image`, or `images` must be provided.\nSupplying only `prompt` performs text-to-image (T2I); supplying\n`image` or `images` performs image-to-image/editing (I2I), which\nsupports 1-3 reference images.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QwenImage30GenerationRequest"
              },
              "examples": {
                "textToImage": {
                  "summary": "Text-to-image",
                  "value": {
                    "model": "qwen-image-3.0-pro",
                    "prompt": "A cyberpunk-style cat with neon lights and cinematic composition",
                    "size": "1024*1024",
                    "n": 1,
                    "seed": 123456,
                    "watermark": false
                  }
                },
                "imageToImage": {
                  "summary": "Image-to-image / editing",
                  "value": {
                    "model": "qwen-image-3.0",
                    "prompt": "Convert the reference image to Chinese ink-wash painting style while preserving the subject and composition",
                    "image": "https://example.com/reference.png",
                    "size": "1536*1024",
                    "prompt_extend": true,
                    "watermark": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Image generation response. Generated image URLs are valid for 24 hours.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30GenerationResponse"
                },
                "examples": {
                  "generatedImages": {
                    "summary": "Generated image URLs",
                    "value": {
                      "created": 1775558400,
                      "data": [
                        {
                          "url": "https://example.com/generated-image-1.png"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters or image generation error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "agentWithImage": {
                    "summary": "agent prompt_extend_mode with image input",
                    "value": {
                      "error": {
                        "code": "InvalidParameter",
                        "message": "prompt_extend_mode=agent is only supported for text-to-image (T2I)"
                      },
                      "request_id": "req_202604021530000001"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/QwenImage30InvalidParameterError"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/submit": {
      "post": {
        "tags": [
          "Qwen Image 3.0"
        ],
        "operationId": "submitQwenImage30Task",
        "summary": "Qwen Image 3.0 Async Image Generation",
        "description": "Submit an asynchronous image generation task. On success, a `task_id`\nis returned; query `GET /v1/tasks/status` to poll for status and results.\n\nAt least one of `input.prompt`, `input.images`, or `input.img_url` must\nbe provided. Supplying only `input.prompt` performs text-to-image (T2I);\nsupplying `input.images` or `input.img_url` performs image-to-image/editing\n(I2I), which supports 1-3 reference images.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QwenImage30TaskSubmitRequest"
              },
              "examples": {
                "textToImage": {
                  "summary": "Text-to-image task",
                  "value": {
                    "model": "qwen-image-3.0-pro",
                    "input": {
                      "prompt": "A cyberpunk-style cat with neon lights and cinematic composition"
                    },
                    "parameters": {
                      "size": "1024*1024",
                      "prompt_extend": true,
                      "watermark": false
                    }
                  }
                },
                "imageToImage": {
                  "summary": "Image-to-image / editing task",
                  "value": {
                    "model": "qwen-image-3.0",
                    "input": {
                      "prompt": "Convert the reference images to Chinese ink-wash painting style while preserving the subject and composition",
                      "images": [
                        "https://example.com/reference-1.png",
                        "https://example.com/reference-2.png"
                      ]
                    },
                    "parameters": {
                      "size": "1536*1024",
                      "prompt_extend": true,
                      "prompt_extend_mode": "direct",
                      "seed": 123456
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Task submitted successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30TaskSubmitResponse"
                },
                "examples": {
                  "submitted": {
                    "summary": "Submitted task",
                    "value": {
                      "output": {
                        "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d"
                      },
                      "request_id": "req_202604021530000001"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters or task submission error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "agentWithImage": {
                    "summary": "agent prompt_extend_mode with image input",
                    "value": {
                      "error": {
                        "code": "InvalidParameter",
                        "message": "prompt_extend_mode=agent is only supported for text-to-image (T2I)"
                      },
                      "request_id": "req_202604021530000001"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/QwenImage30InvalidParameterError"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/status": {
      "get": {
        "tags": [
          "Qwen Image 3.0"
        ],
        "operationId": "getQwenImage30TaskStatus",
        "summary": "Qwen Image 3.0 Image Task Status",
        "description": "Query the execution status, result URLs, and usage details of an asynchronous image task.",
        "parameters": [
          {
            "name": "task_id",
            "in": "query",
            "required": true,
            "description": "Asynchronous task identifier returned by `/v1/tasks/submit`.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "documented": {
                "summary": "Source documentation placeholder",
                "value": "<task_id>"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Task status response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30TaskStatusResponse"
                },
                "examples": {
                  "success": {
                    "summary": "Successful task",
                    "value": {
                      "output": {
                        "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
                        "task_status": "Success",
                        "urls": [
                          "https://example.com/generated-image-1.png"
                        ],
                        "submit_time": 1775115000,
                        "finish_time": 1775115038
                      },
                      "usage": {
                        "image_count": 1,
                        "input_image_count": 0,
                        "pixel_count": 1048576
                      },
                      "request_id": ""
                    }
                  },
                  "failure": {
                    "summary": "Failed task",
                    "value": {
                      "output": {
                        "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
                        "task_status": "Failure",
                        "submit_time": 1775115000,
                        "finish_time": 1775115012,
                        "error_message": "code=InvalidParameter, message=invalid image url"
                      },
                      "request_id": ""
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid task identifier or task status error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "invalidTaskId": {
                    "$ref": "#/components/examples/QwenImage30InvalidTaskIdError"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QwenImage30ErrorResponse"
                },
                "examples": {
                  "error": {
                    "$ref": "#/components/examples/QwenImage30InvalidTaskIdError"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "ModelVerse API key sent in the `Authorization: Bearer <MODELVERSE_API_KEY>` header."
      }
    },
    "schemas": {
      "QwenImage30Model": {
        "type": "string",
        "enum": [
          "qwen-image-3.0",
          "qwen-image-3.0-pro"
        ],
        "description": "Model name. `qwen-image-3.0` is the standard model and `qwen-image-3.0-pro` is the Pro model; both support text-to-image and image-to-image/editing."
      },
      "QwenImage30GenerationRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model"
        ],
        "anyOf": [
          {
            "required": [
              "prompt"
            ]
          },
          {
            "required": [
              "image"
            ]
          },
          {
            "required": [
              "images"
            ]
          }
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/QwenImage30Model"
          },
          "prompt": {
            "type": "string",
            "minLength": 1,
            "description": "Text prompt describing the desired content, style, and composition. Supports Chinese and English, recommended to stay within 4500 tokens."
          },
          "image": {
            "$ref": "#/components/schemas/QwenImage30InputImage"
          },
          "images": {
            "$ref": "#/components/schemas/QwenImage30InputImages"
          },
          "size": {
            "$ref": "#/components/schemas/QwenImage30Size"
          },
          "n": {
            "$ref": "#/components/schemas/QwenImage30Count"
          },
          "seed": {
            "$ref": "#/components/schemas/QwenImage30Seed"
          },
          "negative_prompt": {
            "type": "string",
            "description": "Negative prompt describing content to avoid in the output image."
          },
          "watermark": {
            "$ref": "#/components/schemas/QwenImage30Watermark"
          },
          "prompt_extend": {
            "$ref": "#/components/schemas/QwenImage30PromptExtend"
          },
          "prompt_extend_mode": {
            "$ref": "#/components/schemas/QwenImage30PromptExtendMode"
          },
          "enable_thinking": {
            "$ref": "#/components/schemas/QwenImage30EnableThinking"
          }
        }
      },
      "QwenImage30TaskSubmitRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/QwenImage30Model"
          },
          "input": {
            "$ref": "#/components/schemas/QwenImage30TaskInput"
          },
          "parameters": {
            "$ref": "#/components/schemas/QwenImage30TaskParameters"
          }
        }
      },
      "QwenImage30TaskInput": {
        "type": "object",
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "prompt"
            ]
          },
          {
            "required": [
              "images"
            ]
          },
          {
            "required": [
              "img_url"
            ]
          }
        ],
        "properties": {
          "prompt": {
            "type": "string",
            "minLength": 1,
            "description": "Text prompt describing the desired content, style, and composition. Supports Chinese and English, recommended to stay within 4500 tokens."
          },
          "negative_prompt": {
            "type": "string",
            "description": "Negative prompt describing content to avoid in the output image."
          },
          "images": {
            "$ref": "#/components/schemas/QwenImage30InputImages"
          },
          "img_url": {
            "$ref": "#/components/schemas/QwenImage30InputImage"
          }
        }
      },
      "QwenImage30TaskParameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "size": {
            "$ref": "#/components/schemas/QwenImage30Size"
          },
          "n": {
            "$ref": "#/components/schemas/QwenImage30Count"
          },
          "seed": {
            "$ref": "#/components/schemas/QwenImage30Seed"
          },
          "watermark": {
            "$ref": "#/components/schemas/QwenImage30Watermark"
          },
          "prompt_extend": {
            "$ref": "#/components/schemas/QwenImage30PromptExtend"
          },
          "prompt_extend_mode": {
            "$ref": "#/components/schemas/QwenImage30PromptExtendMode"
          },
          "enable_thinking": {
            "$ref": "#/components/schemas/QwenImage30EnableThinking"
          }
        }
      },
      "QwenImage30InputImage": {
        "type": "string",
        "minLength": 1,
        "description": "Input image as a public URL (HTTP/HTTPS) or Base64 Data URL (formatted as\n`data:{MIME_type};base64,{base64_data}`). Supported formats are JPG, JPEG,\nPNG, BMP, TIFF, WEBP, and GIF; width and height should each be in the\n`[384, 2048]` pixel range, and each image must be no larger than 10 MB.\nImage-to-image (I2I) supports 1-3 reference images.\n",
        "examples": [
          "https://example.com/reference.png"
        ]
      },
      "QwenImage30InputImages": {
        "type": "array",
        "minItems": 1,
        "maxItems": 3,
        "description": "Multiple reference images. Image-to-image (I2I) supports 1-3 images;\narray order defines image order.\n",
        "items": {
          "$ref": "#/components/schemas/QwenImage30InputImage"
        }
      },
      "QwenImage30Size": {
        "type": "string",
        "description": "Output image resolution written as `WIDTH*HEIGHT`, for example `\"1024*1024\"`.\nWhen omitted, the model recommends a resolution based on the prompt.\nTotal pixel area must be between `512*512` and `2048*2048`, and the aspect\nratio must be between `1:8` and `8:1`.\n",
        "pattern": "^[1-9][0-9]*\\*[1-9][0-9]*$",
        "examples": [
          "1024*1024",
          "1536*1024",
          "2048*2048"
        ]
      },
      "QwenImage30Count": {
        "type": "integer",
        "minimum": 1,
        "maximum": 6,
        "default": 1,
        "description": "Number of output images, from 1 to 6. Defaults to 1."
      },
      "QwenImage30Seed": {
        "type": "integer",
        "minimum": 0,
        "maximum": 2147483647,
        "description": "Random seed in the range `[0, 2147483647]`. When omitted, the service picks a seed randomly; a fixed seed makes results relatively stable."
      },
      "QwenImage30Watermark": {
        "type": "boolean",
        "default": false,
        "description": "Whether to add a watermark to the generated image. Defaults to `false`."
      },
      "QwenImage30PromptExtend": {
        "type": "boolean",
        "default": true,
        "description": "Whether to enable intelligent prompt rewriting. Defaults to `true` (recommended). When enabled, the model optimizes the prompt using the method specified by `prompt_extend_mode`."
      },
      "QwenImage30PromptExtendMode": {
        "type": "string",
        "default": "direct",
        "enum": [
          "direct",
          "agent"
        ],
        "description": "Prompt rewriting method. Defaults to `direct`.\n- `direct`: direct prompt enhancement (DPE), suitable for most scenarios; supported for both T2I and I2I.\n- `agent`: agent prompt enhancement (APE), provides finer rewriting and is only supported for text-to-image (T2I). Passing `agent` in an I2I request returns a 400 error.\n"
      },
      "QwenImage30EnableThinking": {
        "type": "boolean",
        "default": true,
        "description": "Whether to enable thinking mode. Defaults to `true`. When enabled, the model\nstrengthens reasoning to improve image quality at the cost of higher latency.\nEffective only when `prompt_extend=true`, and applies to Direct T2I, Direct I2I,\nand Agent T2I; I2I Agent is not supported.\n"
      },
      "QwenImage30GenerationResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "created",
          "data"
        ],
        "properties": {
          "created": {
            "type": "integer",
            "description": "Unix timestamp in seconds for request creation."
          },
          "data": {
            "type": "array",
            "description": "Generated image URL list.",
            "items": {
              "$ref": "#/components/schemas/QwenImage30UrlData"
            }
          }
        }
      },
      "QwenImage30UrlData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Generated image download URL in PNG format. Links are valid for 24 hours."
          }
        }
      },
      "QwenImage30TaskSubmitResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "task_id"
            ],
            "properties": {
              "task_id": {
                "type": "string",
                "description": "Asynchronous task identifier used for subsequent status queries."
              }
            }
          },
          "request_id": {
            "type": "string",
            "description": "Request identifier."
          }
        }
      },
      "QwenImage30TaskStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "$ref": "#/components/schemas/QwenImage30TaskStatusOutput"
          },
          "usage": {
            "$ref": "#/components/schemas/QwenImage30Usage"
          },
          "request_id": {
            "type": "string",
            "description": "Request identifier."
          }
        }
      },
      "QwenImage30TaskStatusOutput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "task_id",
          "task_status"
        ],
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Asynchronous task identifier."
          },
          "task_status": {
            "type": "string",
            "enum": [
              "Pending",
              "Running",
              "Success",
              "Failure",
              "Cancelled"
            ],
            "description": "Task status."
          },
          "urls": {
            "type": "array",
            "description": "Generated image result URLs. Links are valid for 24 hours.",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "submit_time": {
            "type": "integer",
            "description": "Task submission timestamp."
          },
          "finish_time": {
            "type": "integer",
            "description": "Task finish timestamp."
          },
          "error_message": {
            "type": "string",
            "description": "Error message returned when the task fails."
          }
        }
      },
      "QwenImage30Usage": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "image_count": {
            "type": "integer",
            "description": "Number of output images actually generated."
          },
          "input_image_count": {
            "type": "integer",
            "description": "Number of input images in the request. 0 for text-to-image (T2I); for image-to-image (I2I) it reflects the actual number of input images."
          },
          "pixel_count": {
            "type": "integer",
            "description": "Output image pixel value (width x height), used for pixel-tiered billing."
          }
        }
      },
      "QwenImage30ErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "additionalProperties": true,
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Error code.",
                "examples": [
                  "InvalidParameter"
                ]
              },
              "message": {
                "type": "string",
                "description": "Error message.",
                "examples": [
                  "invalid image url"
                ]
              }
            }
          },
          "request_id": {
            "type": "string",
            "description": "Optional request identifier."
          }
        }
      }
    },
    "examples": {
      "QwenImage30InvalidParameterError": {
        "summary": "Invalid parameter",
        "value": {
          "error": {
            "code": "InvalidParameter",
            "message": "invalid image url"
          },
          "request_id": "req_202604021530000001"
        }
      },
      "QwenImage30InvalidTaskIdError": {
        "summary": "Invalid task ID",
        "value": {
          "error": {
            "code": "InvalidParameter",
            "message": "invalid task_id"
          },
          "request_id": "req_202604021530000001"
        }
      }
    }
  }
}
```