> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Qwen Image 3.0 Pro Edit > [Core Function] Qwen Image 3.0 Pro Edit is an image-to-image editing model for instruction-based edits and multi-image fusion. [Strengths] It accepts 1-3 reference images plus an edit instruction, optional negative prompts, free-form output size (width*height), intelligent prompt rewrite, 1-6 outputs while preserving subject identity, and long structured edit instructions. [Best For] Highly recommended for: background replacement, outfit or style changes, multi-image fusion, identity-preserving portrait edits, and iterative creative retouching. [Limitations] Do NOT use this for pure text-to-image with no reference images (use Qwen Image 3.0 Pro instead), native 4K output, or thinking-mode reasoning. Keep output total pixels within 512*512 to 2048*2048; input images should follow supported formats and size guidance. Do NOT combine very long prompts with multiple reference images and a long negative_prompt if the request may exceed the model input capacity (about 4.5k tokens total across text and images). [Routing] Route here when the user provides reference image(s) and wants Qwen 3.0 edit quality. For text-only generation without images, use Qwen Image 3.0 Pro. ## OpenAPI ````yaml /model-api/alibaba/alibaba-i2i.json post /alibaba/qwen-image-3.0-pro-edit openapi: 3.1.0 info: description: The image-to-image models API from Alibaba. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Alibaba Image-to-Image Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-image models API from Alibaba. security: - bearerAuth: [] paths: /alibaba/qwen-image-3.0-pro-edit: post: summary: Qwen Image 3.0 Pro Edit description: >- [Core Function] Qwen Image 3.0 Pro Edit is an image-to-image editing model for instruction-based edits and multi-image fusion. [Strengths] It accepts 1-3 reference images plus an edit instruction, optional negative prompts, free-form output size (width*height), intelligent prompt rewrite, 1-6 outputs while preserving subject identity, and long structured edit instructions. [Best For] Highly recommended for: background replacement, outfit or style changes, multi-image fusion, identity-preserving portrait edits, and iterative creative retouching. [Limitations] Do NOT use this for pure text-to-image with no reference images (use Qwen Image 3.0 Pro instead), native 4K output, or thinking-mode reasoning. Keep output total pixels within 512*512 to 2048*2048; input images should follow supported formats and size guidance. Do NOT combine very long prompts with multiple reference images and a long negative_prompt if the request may exceed the model input capacity (about 4.5k tokens total across text and images). [Routing] Route here when the user provides reference image(s) and wants Qwen 3.0 edit quality. For text-only generation without images, use Qwen Image 3.0 Pro. operationId: qwenImage30ProEditAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/QwenImage30ProEditRequest' examples: basic: summary: Single-image edit value: images: - https://example.com/portrait.png prompt: Change the background to a modern cafe responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: QwenImage30ProEditRequest: type: object required: - images - prompt properties: prompt: type: string description: Image editing instruction (positive prompt) minLength: 1 maxLength: 4500 example: Change the background to a beach scene images: type: array description: Input image URL array, supports 1-3 images minItems: 1 maxItems: 3 items: type: string format: uri example: - https://example.com/input.jpg negative_prompt: type: string description: Negative prompt describing unwanted content maxLength: 500 'n': type: integer description: Number of output images default: 1 minimum: 1 maximum: 6 size: type: string description: >- Output image resolution as width*height (e.g. 1024*1024). Optional; when omitted the model auto-selects. Total pixels should stay within 512*512 to 2048*2048. pattern: ^\d+\*\d+$ example: 1024*1024 prompt_extend: type: boolean description: Enable intelligent prompt rewriting default: true seed: type: integer description: Random seed for reproducibility minimum: 0 maximum: 2147483647 AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: parameter ''images'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''images'' is required' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: Bearer `YOUR_API_KEY`.' ````