Skip to main content
POST
/
image
/
multi-edit
/api/v1/image/multi-edit
curl --request POST \
  --url https://api.venice.ai/api/v1/image/multi-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "modelId": "qwen-edit"
}
'
"<string>"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

Edit an image by compositing up to three layered images with a single prompt. Supports base64-encoded strings and URLs.

​
prompt
string
required

The text directions to edit or modify the image. Short, descriptive prompts work best (e.g., "remove the tree", "change the sky to sunrise"). Character limit is model specific and is listed in the promptCharacterLimit setting in the model list endpoint.

Required string length: 1 - 32768
​
images
(string<uri> | string)[]
required

Array of 1 to 3 images used for multi-editing. The first image is treated as the base image, and the remaining images are used as edit layers/masks. Each image can be a base64-encoded string or a URL starting with http:// or https://. Image dimensions must be at least 65536 pixels and must not exceed 33177600 pixels. File size must be less than 25MB.

Required array length: 1 - 3 elements

Image as a base64-encoded string or a URL starting with http:// or https://

​
modelId
enum<string>
default:qwen-edit

The model ID to use for multi-edit.

Available options:
qwen-edit,
flux-2-max-edit,
gpt-image-1-5-edit,
nano-banana-pro-edit,
seedream-v4-edit
Minimum string length: 1

Response

OK

The response is of type file.