Edit Image with a Prompt

post

https://genai-api.picsart.io/v1/painting/edit

Edit any image with a prompt. Apply any transformation, any type of detail you can imaging and the AI will apply it to the image.
Choose from the big range of models if you have preferences or to take control of the output quality.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This is an asynchronous process. Use the provided transaction identifier to pull the result with Get the Edit Image result.

Body Params

image

file

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)

image_url

uri

length between 1 and 2083

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image_id

string

deprecated

Deprecated. Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)

prompt

string

required

The prompt.

count

integer

1 to 10

Defaults to 2

The number of images to generate.

format

string

enum

Defaults to JPG

Optionally select one of the image formats (JPG is default). Options are as follows:

JPG
PNG
WEBP

Allowed:

mode

string

enum

Defaults to sync

deprecated

Deprecated. The mode parameter is now deprecated. To control synchronous vs asynchronous execution, use the standard HTTP Prefer header (RFC 7240). If both mode and Prefer are provided, Prefer takes precedence. For migration guidance and examples, see the Sync and Async Execution guide.
Use this query parameter to establish the processing mode. Acceptable values are sync, async and auto (sync is default):

sync: issues a synchronous request, response is given when the result is ready.
async: forces an asynchronous request, the response, which is instantaneous, contains a "transaction_id" which is used to poll for the result.
REMOVED - auto: the processing mode decision is made by the service, which depends upon the expected processing time.

Allowed:

model

string | null

enum

Defaults to urn:air:sdxl:model:fluxai:flux_kontext_max-image-to-image@1

Optionally choose a specific AI model to use for this request.
If not specified, a default model will be applied. Please note that the default model may change over time as Picsart continues to improve performance and accuracy. Any change to the default will be made only after thorough testing and validation to ensure it delivers better results.
If you require consistent behavior or wish to evaluate different models on your own, we recommend explicitly setting this parameter.

Responses

200Success.

202Processing.

400Bad Request

401Unauthorized

402Payment Required

403Forbidden

404Not Found

405Method Not Allowed

413Request Entity Too Large

415Unsupported Media Type

429Too Many Requests

431Request Header Fields Too Large

500Internal Server Error

503Service Unavailable