Edits and variations use the native OpenAI endpoints with multipart/form-data bodies (the only place on the platform where files are uploaded directly), returning results synchronously.
Authorizations
AuthorizationstringRequired
Bearer Token authentication.
Authorization: Bearer YOUR_API_KEYImage edits
POST /v1/images/editsForm fields (native OpenAI): model (required), image (required, may repeat per model support), prompt (required), mask (optional PNG, transparent = repaint area, same size as source), plus n / size / quality / response_format.
Image variations
POST /v1/images/variationsForm fields: model, image (required), n, size, response_format.
Notes
- Long synchronous request — client timeout ≥ 180 seconds recommended
- Total request size (including files) capped at 32MB
- Image count / format / mask support varies per model; refer to the upstream docs