Skip to main content
POST
/
image
/
edit
/api/v1/image/edit
curl --request POST \
  --url https://api.venice.ai/api/v1/image/edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Colorize",
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB7GkOtAAAAIGNIUk0A..."
}
'
"<string>"
This is an experimental endpoint and may be subject to change.
Pricing: Image editing/inpainting pricing varies by model. The default model (qwen-edit) is $0.04 per edit. See the Models endpoint for all available inpaint models and their pricing.

​
Postman Collection

For additional examples, please see this Postman Collection.
The default model (qwen-edit) blocks requests that try to generate explicit sexual imagery, sexualize minors, or depict real-world violence. Other models may have different content policies.

Authorizations

​
Authorization
string
header
required

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

Body

Edit an image based on the supplied prompt.

​
image
required

The image to edit. Can be either a file upload, 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.

​
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
Example:

"Change the color of the sky to a sunrise"

​
aspect_ratio
enum<string>

The aspect ratio for the output image. Omit this parameter to use the model's default setting. Supported values vary by model - check GET /api/v1/models for model-specific options.

Available options:
auto,
1:1,
3:2,
16:9,
21:9,
9:16,
2:3,
3:4,
4:5
Example:

"16:9"

​
modelId
enum<string>
default:qwen-edit

The model ID to use for image editing.

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.