Edit image (image-to-image)
POST
/images/edits
const url = 'https://example.com/images/edits';const form = new FormData();form.append('image', 'example');form.append('model', 'example');form.append('prompt', 'example');form.append('n', '1');form.append('size', 'example');form.append('aspect_ratio', 'example');form.append('resolution', 'example');form.append('quality', 'example');form.append('response_format', 'example');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/images/edits \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form image=example \ --form model=example \ --form prompt=example \ --form n=1 \ --form size=example \ --form aspect_ratio=example \ --form resolution=example \ --form quality=example \ --form response_format=exampleOpenAI-compatible image-to-image: multipart image (one or more reference images) + prompt + model. Returns base64 (b64_json). Only models that accept image input (GET /models → image with references: true): Nano Banana / GPT Image 2 / Seedream / Flux. aspect_ratio+resolution (or size) optional. Charged per image.
Authorizations
Заголовок раздела «Authorizations»Request Bodyrequired
Заголовок раздела «Request Bodyrequired»Media typemultipart/form-data
Body_create_image_edit
object
image
required
Image
Reference image(s) for image-to-image.
Array<string>
model
required
Model
string
prompt
required
Prompt
string
n
N
integer
Responses
Заголовок раздела «Responses»Successful Response
Media typeapplication/json
Examplegenerated
exampleValidation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example", "input": "example", "ctx": {} } ]}