{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/qwen-image-3.0-pro-edit"}],"post":{"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":{"content":{"application/json":{"examples":{"basic":{"summary":"Single-image edit","value":{"images":["https://example.com/portrait.png"],"prompt":"Change the background to a modern cafe"}}},"schema":{"properties":{"images":{"description":"Input image URL array, supports 1-3 images","example":["https://example.com/input.jpg"],"items":{"format":"uri","type":"string"},"maxItems":3,"minItems":1,"type":"array"},"n":{"default":1,"description":"Number of output images","maximum":6,"minimum":1,"type":"integer"},"negative_prompt":{"description":"Negative prompt describing unwanted content","maxLength":500,"type":"string"},"prompt":{"description":"Image editing instruction (positive prompt)","example":"Change the background to a beach scene","maxLength":4500,"minLength":1,"type":"string"},"prompt_extend":{"default":true,"description":"Enable intelligent prompt rewriting","type":"boolean"},"seed":{"description":"Random seed for reproducibility","maximum":2147483647,"minimum":0,"type":"integer"},"size":{"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.","example":"1024*1024","pattern":"^\\d+\\*\\d+$","type":"string"}},"required":["images","prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"},"400":{"content":{"application/json":{"example":{"code":400,"message":"Invalid parameters: parameter 'images' is required"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'images' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"example":{"code":401,"message":"Authentication failed: invalid API key"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'images' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Unauthorized - Invalid or missing API Key"},"429":{"content":{"application/json":{"example":{"code":429,"message":"Rate limit exceeded: 100 requests per minute, retry after 60 seconds"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'images' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Too many requests - Rate limit exceeded"},"500":{"content":{"application/json":{"example":{"code":500,"message":"Internal server error"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'images' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"Qwen Image 3.0 Pro Edit","x-mint":{"href":"alibaba/qwen-image-3-0-pro-edit"}}}