{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/qwen-image-3.0-edit"}],"post":{"description":"[Core Function] Qwen Image 3.0 Edit is the standard 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 (direct mode), and 1-6 outputs while preserving subject identity. [Best For] Background replacement, outfit or style changes, multi-image fusion, and iterative retouching when Pro-tier quality is not required. [Limitations] Do NOT use this for pure text-to-image with no reference images (use Qwen Image 3.0 instead). Keep output total pixels within 512*512 to 2048*2048. prompt_extend_mode only supports direct (agent is T2I-only). [Routing] Route here when the user provides reference image(s) and wants balanced Qwen 3.0 edit quality. Prefer Qwen Image 3.0 Pro Edit for higher quality edits.","operationId":"qwenImage30EditAsync","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","prompt_extend_mode":"direct"}}},"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":"Whether to enable intelligent prompt rewriting. Default true (recommended). When enabled, the model rewrites the positive prompt using the mode specified by prompt_extend_mode; most effective for short or simple prompts.","type":"boolean"},"prompt_extend_mode":{"default":"direct","description":"Prompt rewrite mode when prompt_extend is true. Default direct. direct: Direct Prompt Enhancement (DPE), suitable for most scenarios (supported for I2I). agent (Agent Prompt Enhancement / APE) is text-to-image only and is rejected for image editing.","enum":["direct"],"example":"direct","type":"string"},"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 Edit","x-mint":{"href":"alibaba/qwen-image-3-0-edit"}}}