Image Edits
OpenAI-compatible image-edit endpoint.
Accepts either application/json (gpt-image-style images: [{file_id|image_url}])
or multipart/form-data (OpenAI SDK classic shape: image[] UploadFile,
optional mask UploadFile, plus text fields). Content-Type drives dispatch.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
OpenAI-compatible POST /v1/images/edits JSON request body.
References:
- OpenAI's current /v1/images/edits JSON form for gpt-image-* takes
images: [{file_id | image_url}, ...]and an optionalmask: {file_id | image_url}. image_urlaccepts an https URL or adata:image/...;base64,...URL.
provider/model, e.g. 'openai/gpt-image-2'
1 - 32000One or more input images. Each entry references one image via exactly one of file_id (an Eden upload id) or image_url (https URL or base64 data URL). The first image is the canvas; subsequent images are inpaint references.
1 - 16 elements1 <= x <= 10Provider-specific size string. OpenAI accepts '1024x1024', '1536x1024', '1024x1536', 'auto'. Vertex Imagen accepts square or aspect-ratio strings. Validation is delegated to the provider.
End-user identifier for abuse tracking.
Arbitrary metadata attached to the request.
Additional HTTP headers forwarded to the provider API. Credential headers (Authorization, x-api-key, ...) are rejected.
Optional mask image (PNG with transparent pixels marking the regions to edit). Same shape as an images[] entry.
Response
Successful Response