Image

/api/v1/image/multi-edit

Edit or modify an image using multiple layered inputs (base image plus masks/overlays), up to the selected model's maximum input images (see the capabilities.maxInputImages field in GET /api/v1/models).

Supported input formats by Content-Type:

multipart/form-data: Only file uploads are supported. Send images as form file fields.
application/json: Base64 strings and URLs are supported:
- Raw base64 string: "iVBORw0KGgoAAAANSUhEUgAA..."
- Data URL: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
- HTTP/HTTPS URL: "https://example.com/image.png"

For models with resolution tiers that require explicit dimensions, omit aspect_ratio or set it to auto to infer the closest supported aspect ratio from the first input image. Provide aspect_ratio directly when exact output dimensions are required. Use output_format to request jpeg, jpg, png, or webp output.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

post/api/v1/image/multi-edit

Request

Base URL: https://api.venice.ai
URL: https://api.venice.ai/api/v1/image/multi-edit
Auth: one of:
- HTTP bearer
- API key in header SIGN-IN-WITH-X

Request body

anon_user_idstring

Optional identifier for the API customer's end user. Combined with the Venice user id when attributing the request to upstream providers. Distinct from the discarded OpenAI user field. Must be printable ASCII and must not contain ||.

aspect_ratio'auto' | '1:1' | '3:2' | '16:9' | '21:9' | '9:16' | '2:3' | '3:4' | '4:3' | '4:5'

The aspect ratio for the output image. Use 'auto' or omit this parameter to infer the closest supported aspect ratio from the first input image when explicit sizing is required by the model.

The model ID to use for multi-edit.

output_format'jpeg' | 'png' | 'webp'

Output format for the edited image. Accepts jpeg, jpg, png, or webp. When omitted, the format is inferred from resolution: PNG for 1K edits and JPEG for 2K/4K edits.

promptstring 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.

quality'low' | 'medium' | 'high'

Output quality for supported models (e.g. GPT Image 2 / GPT Image 2 Edit). Higher values can increase the final request charge. See the model list for supported options.

resolutionstring

Resolution tier for the output image (e.g. "1K", "2K", "4K"). Supported values vary by model - check GET /api/v1/models for model-specific options. Defaults to "1K" when not specified.

safe_modeboolean

Whether to blur images classified as adult content. Defaults to true. Set to false to receive unblurred output. No Pro subscription is required, and the mature filter setting in the Venice app does not affect this. The x-venice-is-blurred response header reports whether the returned image was blurred.

disable_prompt_optimization_thinkingboolean

Skip the model's prompt-optimization thinking step for faster generation. Only supported by models with supportsOptimizePromptThinking; ignored by others. Omit to use the model default.

enhance_promptboolean

Rewrite the edit prompt using the input images before editing to add clarifying detail. Additional credits are charged when a rewrite is generated. Adds up to ~30 seconds. When enhancement is applied, the final prompt is returned URL-encoded in the x-venice-enhanced-prompt response header. Defaults to false.

Example request

{
  "anon_user_id": "end-user-123",
  "aspect_ratio": "16:9",
  "output_format": "png",
  "quality": "high",
  "resolution": "1K"
}

Response

Changes

No recorded changes to this operation across all 1 revision of this API.