Skip to navigation
API ReferenceImages

Edit an image

Edits an existing image according to a text instruction with an image-edit model such as step-image-edit-2. Accepts the same asynchronous job envelope as image generation: poll GET /v1/jobs/{job_id} for the signed output URL.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Request

This endpoint expects an object.
promptstringRequired
The edit instruction.
imagestringRequired
The https URL of the image to edit.
modelstringOptional

Image-edit model id (default step-image-edit-2).

response_formatenumOptional

Output format; url (default) returns signed URLs.

Allowed values:

Response

Job accepted; poll GET /v1/jobs/{job_id}.

job_idstringOptional
statusenumOptional
Allowed values:
progressdoubleOptional0-1
created_atdatetimeOptional
completed_atdatetime or nullOptional
resultobject or nullOptional
errorobject or nullOptional