Image

/api/v1/image/edit

Edit or modify an image based on the supplied prompt. The image can be provided either as a multipart form-data file upload or as a base64-encoded string in a JSON request. 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 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/edit

Request

  • Base URL: https://api.venice.ai
  • URL: https://api.venice.ai/api/v1/image/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 input image when explicit sizing is required by the model. Supported values vary by model - check GET /api/v1/models for model-specific options.

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

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.

modelstring

The model ID to use for image editing.

modelId'firered-image-edit' | 'qwen-edit-uncensored' | 'grok-imagine-edit' | 'grok-imagine-quality-edit' | 'grok-imagine-image-2-0-edit' | 'qwen-image-2-edit' | 'qwen-image-2-pro-edit' | 'wan-2-7-pro-edit' | 'flux-2-max-edit' | 'flux-3-image-edit' | 'gpt-image-2-5-flare-edit' | 'gpt-image-2-5-sunburst-edit' | 'gpt-image-2-edit' | 'gpt-image-1-5-edit' | 'ideogram-v4-5-edit' | 'nano-banana-2-edit' | 'nano-banana-2-1-edit' | 'nano-banana-pro-edit' | 'nano-banana-2-lite-edit' | 'luma-uni-1-edit' | 'luma-uni-1-max-edit' | 'muse-image-edit' | 'seedream-v5-lite-edit' | 'seedream-v5-pro-edit' | 'seedream-v4-edit' | 'qwen-image-3-edit' | 'qwen-image-3-pro-edit' | 'qwen-image-2-1-turbo-edit' | 'qwen-image-2-1-pro-edit'

Deprecated: Use "model" instead. The model ID to use for image editing.

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.

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.

Example request

{
  "prompt": "Colorize",
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB7GkOtAAAAIGNIUk0A..."
}

Response

OK

Changes

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