{"servers":[{"url":"https://api.modellix.ai/api/v1/openai/gpt-image-1.5-edit"}],"post":{"description":"OpenAI's image-editing model for combining references, cutouts, and masked changes while keeping the source recognizable. It accepts 1 to 16 images, can hold closely to the original, and can return a transparent background at 1024 or 1536 pixels on the long edge.","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-excluded":true,"x-mint":{"href":"openai/gpt-image-1-5-edit"}}}