{"servers":[{"url":"https://api.modellix.ai/api/v1/openai/gpt-image-1.5-edit"}],"post":{"description":"[Core Function] GPT Image 1.5 Edit is a versatile image-to-image editing and merging model. [Strengths] It excels at complex utility editing tasks, including multi-image merging (up to 16 images), transparent background support, and precise control over how strictly the model adheres to the input image (fidelity control). [Best For] Highly recommended for: merging reference images, editing UI assets, generating variations with strict shape preservation, and creating transparent cutouts. [Limitations] Do NOT use this model if you require 2K or 4K high-resolution outputs, as it is limited to standard resolutions. [Routing] Use this model specifically when the user provides multiple images to combine, requires transparency, or explicitly asks to 'keep the exact shape' of the original image (fidelity control). Otherwise, use GPT Image 2 Edit.","operationId":"gptImage15EditAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Basic image editing","value":{"images":[{"image_url":"https://example.com/input.png"}],"prompt":"Convert to vintage style"}},"multi_image":{"summary":"Multi-image merge editing","value":{"images":[{"image_url":"https://example.com/image1.png"},{"image_url":"https://example.com/image2.png"},{"image_url":"https://example.com/image3.png"}],"prompt":"Merge these images into a cohesive collage"}},"transparent":{"summary":"Generate transparent background","value":{"background":"transparent","images":[{"file_id":"file-abc123"}],"prompt":"Remove background, keep only the main subject"}}},"schema":{"description":"Request payload for standard GPT Image Edit models.","properties":{"background":{"default":"auto","description":"Background transparency. 'transparent': transparent background (requires png or webp format), 'opaque': solid background, 'auto': model decides","enum":["transparent","opaque","auto"],"example":"transparent","type":"string"},"images":{"description":"Input image URL(s) to edit. Direct HTTPS URLs as string array. Supports up to 16 images for GPT Image models","example":["https://example.com/input.png"],"items":{"description":"Direct image URL (https only)","example":"https://example.com/image.png","type":"string"},"maxItems":16,"minItems":1,"type":"array"},"input_fidelity":{"description":"Control fidelity to original input image. 'high': preserve original details, 'low': more creative freedom","enum":["high","low"],"example":"high","type":"string"},"mask":{"description":"Optional mask URL. Must be PNG with alpha channel; dimensions must match the input image exactly. Transparent areas are edited, opaque areas locked, semi-transparent areas blend with the original.","example":"https://example.com/mask.png","type":"string"},"prompt":{"description":"Description of the desired edits, supports up to 32,000 characters","example":"Add a watercolor effect to this image","maxLength":32000,"minLength":1,"type":"string"},"quality":{"default":"low","description":"Output quality level. 'low': fast draft (default), 'medium': balanced, 'high': best quality","enum":["low","medium","high"],"example":"high","type":"string"},"size":{"default":"1024x1024","description":"Output image size. Preset resolutions only","enum":["1024x1024","1536x1024","1024x1536"],"example":"1024x1024","type":"string"}},"required":["images","prompt"],"type":"object"}}},"description":"Request payload for standard GPT Image Edit models.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"Response object for asynchronous task submission.","properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"model_id":{"description":"Model identifier used for this task","example":"gpt-image-2-edit","type":"string"},"status":{"description":"Task status","enum":["pending","processing","completed","failed"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for status polling","example":"task_abc123xyz","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":{"schema":{"description":"Standard error response object.","properties":{"code":{"description":"Error code","example":400,"type":"integer"},"details":{"additionalProperties":true,"description":"Additional error details","type":"object"},"message":{"description":"Error message","example":"Invalid request parameters","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"schema":{"description":"Standard error response object.","properties":{"code":{"description":"Error code","example":400,"type":"integer"},"details":{"additionalProperties":true,"description":"Additional error details","type":"object"},"message":{"description":"Error message","example":"Invalid request parameters","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Authentication required or invalid"},"429":{"content":{"application/json":{"schema":{"description":"Standard error response object.","properties":{"code":{"description":"Error code","example":400,"type":"integer"},"details":{"additionalProperties":true,"description":"Additional error details","type":"object"},"message":{"description":"Error message","example":"Invalid request parameters","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"description":"Standard error response object.","properties":{"code":{"description":"Error code","example":400,"type":"integer"},"details":{"additionalProperties":true,"description":"Additional error details","type":"object"},"message":{"description":"Error message","example":"Invalid request parameters","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"GPT Image 1.5 Edit","tags":["GPT Image Edit"],"x-mint":{"href":"openai/gpt-image-1-5-edit"}}}