Image Editing

Image editing on Venice is synchronous. Send your source image to /image/edit or /image/multi-edit and the edited result comes back in the same response as a PNG file. For cutouts, /image/background-remove returns a transparent PNG.

The image edit endpoints are experimental and model-specific behavior may change over time.

Endpoints

Endpoint	Purpose	Best for
`POST /image/edit`	Edit a single image with a prompt	General edits and prompt-driven inpainting
`POST /image/multi-edit`	Edit using 1-3 layered images	More controlled edits with masks or overlays
`POST /image/background-remove`	Remove the background from an image	Transparent cutouts for products, portraits, and assets

When to use which endpoint

Use /image/edit when you have one source image and want to change, remove, or restyle part of it with a prompt.
Use /image/multi-edit when you need extra control from masks, overlays, or reference layers.
Use /image/background-remove when you only want a clean foreground subject with transparency.

For inpainting, use /image/edit or /image/multi-edit. The old inpaint parameter on /image/generate is deprecated.

Step 1: Edit a single image

Single-image edit is the simplest inpainting flow. Send one image plus a short prompt such as “remove the sign”, “change the sky to sunrise”, or “replace the background with a studio backdrop”. Request:

POST https://api.venice.ai/api/v1/image/edit
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

{
  "model": "qwen-edit",
  "prompt": "Replace the cloudy sky with a warm sunrise while preserving the buildings and canal",
  "image": "https://example.com/venice-canal.jpg"
}

Response (200): The response body is raw image/png binary data. Save it directly to a file.

import base64
import os
import requests

with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

response = requests.post(
    "https://api.venice.ai/api/v1/image/edit",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "qwen-edit",
        "prompt": "Remove the tourist crowd from the square and keep the architecture intact",
        "image": image_base64,
    },
)

with open("edited.png", "wb") as f:
    f.write(response.content)

import fs from "fs";

const imageBase64 = fs.readFileSync("input.jpg").toString("base64");

const response = await fetch("https://api.venice.ai/api/v1/image/edit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-edit",
    prompt: "Remove the tourist crowd from the square and keep the architecture intact",
    image: imageBase64,
  }),
});

const editedImage = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("edited.png", editedImage);

curl https://api.venice.ai/api/v1/image/edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o edited.png \
  -d '{
    "model": "qwen-edit",
    "prompt": "Colorize this black and white portrait naturally",
    "image": "https://example.com/portrait-bw.jpg"
  }'

Step 2: Use multi-edit for masks or layered inpainting

/image/multi-edit accepts up to three images. The first image is the base image. The remaining images are treated as edit layers or masks, which gives you more control than prompt-only editing. This is the better choice when you want to:

target a specific region with a mask
combine an existing composition with an overlay
constrain the edit more tightly than a single-image prompt can

JSON request:

{
  "modelId": "qwen-edit",
  "prompt": "Replace the blank billboard area with a glowing Venice film festival poster while preserving lighting and perspective",
  "images": [
    "https://example.com/street-scene.png",
    "https://example.com/billboard-mask.png"
  ]
}

Multipart request:

curl https://api.venice.ai/api/v1/image/multi-edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -F "modelId=qwen-edit" \
  -F "prompt=Replace the blank billboard area with a glowing Venice film festival poster while preserving lighting and perspective" \
  -F "images=@street-scene.png" \
  -F "images=@billboard-mask.png" \
  -o multi-edited.png

Like /image/edit, the response body is raw image/png data.

/image/multi-edit currently uses the modelId field rather than model in the request schema.

Inpainting tips

Prompt-based inpainting works best when the instruction is short and local:

remove the tree
change the sky to sunset
replace the logo with a blank sign
restore the torn corner of the photo

For broader scene changes, describe what should stay the same:

Replace the background with a modern photo studio backdrop while preserving the subject pose, facial features, and clothing.

If the edit keeps affecting the wrong area, switch from /image/edit to /image/multi-edit and provide a mask or overlay layer.

Step 3: Remove the background

Use /image/background-remove when you want the foreground subject isolated on a transparent background. This endpoint returns a PNG with alpha transparency. Using an image URL:

curl https://api.venice.ai/api/v1/image/background-remove \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o cutout.png \
  -d '{
    "image_url": "https://example.com/product-photo.jpg"
  }'

Using a local file upload:

curl https://api.venice.ai/api/v1/image/background-remove \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -F "image=@product-photo.jpg" \
  -o cutout.png

Use background removal for:

ecommerce product photos
profile photos and portraits
assets you plan to place over a new background

Request Parameters

`/image/edit`

Parameter	Type	Required	Default	Description
`image`	file, base64 string, or URL	Yes	-	Source image to edit
`prompt`	string	Yes	-	Text instructions for the edit
`model`	string	No	`qwen-edit`	Edit model ID
`aspect_ratio`	string	No	model default	Output ratio for models that support it
`modelId`	string	Deprecated	-	Deprecated alias for `model`

`/image/multi-edit`

Parameter	Type	Required	Default	Description
`images`	array of 1-3 files, base64 strings, or URLs	Yes	-	First image is the base image; the rest are edit layers or masks
`prompt`	string	Yes	-	Text instructions for how to combine or edit the layers
`modelId`	string	No	`qwen-edit`	Edit model ID

`/image/background-remove`

Parameter	Type	Required	Description
`image`	file or base64 string	One of `image` or `image_url`	Source image to cut out
`image_url`	string	One of `image` or `image_url`	Public image URL to cut out

Supported input formats

Endpoint	JSON input	Multipart input	Output
`/image/edit`	Base64 string or URL	File upload	`image/png`
`/image/multi-edit`	Base64 strings or URLs	File uploads	`image/png`
`/image/background-remove`	Base64 string or URL	File upload	`image/png`

For edit endpoints, image dimensions must be at least 65536 pixels and no more than 33177600 pixels. Uploaded files must be under 25MB.

Models and pricing

The default edit model is qwen-edit, priced at $0.04 per edit. Other edit-capable models may have different pricing and constraints. See:

Image pricing
Models API with type=inpaint

Errors

Status	Meaning	Action
`400`	Invalid request parameters	Check image count, field names, and input format
`401`	Authentication failed	Check your API key
`402`	Insufficient balance	Add credits at venice.ai/settings/api
`415`	Invalid content type	Use JSON or multipart form-data correctly
`429`	Rate limit exceeded or model overloaded	Retry with backoff; check `Retry-After` header
`500`	Inference processing failed	Retry the request
`503`	Model at capacity	Retry after a short delay

Some edit models have stricter content policies than image generation models. For example, qwen-edit blocks requests involving explicit sexual imagery, sexualized minors, or real-world violence.

Use Image Generation when you’re starting from text instead of an existing image.
Use Image Models to compare generation, edit, and enhancement model families.
Use Image Edit API, Multi-Edit API, and Background Remove API for full schema details.

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

Endpoints

When to use which endpoint

Step 1: Edit a single image

Step 2: Use multi-edit for masks or layered inpainting

Inpainting tips

Step 3: Remove the background

Request Parameters

`/image/edit`

`/image/multi-edit`

`/image/background-remove`

Supported input formats

Models and pricing

Errors

​Endpoints

​When to use which endpoint

​Step 1: Edit a single image

​Step 2: Use multi-edit for masks or layered inpainting

​Inpainting tips

​Step 3: Remove the background

​Request Parameters

​/image/edit

​/image/multi-edit

​/image/background-remove

​Supported input formats

​Models and pricing

​Errors

​Related Workflows

Endpoints

When to use which endpoint

Step 1: Edit a single image

Step 2: Use multi-edit for masks or layered inpainting

Inpainting tips

Step 3: Remove the background

Request Parameters

`/image/edit`

`/image/multi-edit`

`/image/background-remove`

Supported input formats

Models and pricing

Errors

Related Workflows