{"info":{"title":"openai/gpt-image-2.5/flare/edit","version":"1.0.0"},"paths":{"/":{"post":{"summary":"Edit","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Output"}}},"description":"Successful Response"}},"operationId":"gpt_image_2_5_flare_edit","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}},"required":true}}}},"openapi":"3.1.0","components":{"schemas":{"Input":{"type":"object","title":"Input","required":["prompt","image_urls"],"properties":{"prompt":{"type":"string","title":"Prompt","x-order":0,"maxLength":4000,"minLength":1,"description":"The edit instruction. Name the single change you want, then list what must stay the same — subject, layout, lighting, wording. Put any words you want rendered inside the image in quotes."},"mask_url":{"type":"string","title":"Mask URL","format":"uri","x-order":2,"description":"Optional mask restricting the edit to one region. The mask should carry an alpha channel — transparent areas mark where changes are allowed — and match the reference image's size and format. Masking is prompt-guided, so the edited area may not follow the mask's shape exactly."},"image_size":{"allOf":[{"$ref":"#/components/schemas/ImageSizeEnum"}],"title":"Image Size","default":"landscape_4_3","x-order":3,"description":"The aspect ratio and framing of the edited image. Match it to the source image's own aspect ratio unless you want the frame re-composed."},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"title":"Image URLs","x-order":1,"maxItems":2,"minItems":1,"description":"One or two reference images. With one, the edit is applied to it; with two, elements from both can be combined into a single scene — address them in the prompt as 'image 1' and 'image 2'."},"num_images":{"type":"integer","title":"Number of Images","default":1,"maximum":4,"minimum":1,"x-order":4,"description":"How many edited images to generate from this request. Each image is charged as its own generation."},"output_format":{"allOf":[{"$ref":"#/components/schemas/OutputFormatEnum"}],"title":"Output Format","default":"png","x-order":5,"description":"The file format of the edited image."}},"x-fal-order-properties":["prompt","image_urls","mask_url","image_size","num_images","output_format"]},"Output":{"type":"array","items":{"type":"string","format":"uri"},"title":"Output","description":"The edited image files."},"ImageSizeEnum":{"enum":["square_hd","square","portrait_4_3","portrait_16_9","landscape_4_3","landscape_16_9"],"type":"string","title":"ImageSizeEnum","description":"Predefined image sizes."},"OutputFormatEnum":{"enum":["jpeg","png","webp"],"type":"string","title":"OutputFormatEnum","description":"The file format of the edited image."}}}}