{"uid":"cap_oH3Ig9GtAO_a2MMfC_LMs","slug":"venice-ai-multi-edit-8229434a","name":"Venice AI Multi Edit","description":"Combine and edit up to 3 images.","url":"https://api.venice.ai/api/v1/image/multi-edit","method":"POST","headers":{},"bodySchema":{"allOf":[{"type":"object","required":["prompt","images"],"properties":{"images":{"type":"array","items":{"anyOf":[{"type":"string","format":"uri"},{"type":"string"}],"description":"Image as a base64-encoded string or a URL starting with http:// or https://"},"maxItems":3,"minItems":1,"description":"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."},"prompt":{"type":"string","maxLength":32768,"minLength":1,"description":"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."},"modelId":{"type":"string","default":"firered-image-edit","minLength":1,"description":"The model ID to use for multi-edit."},"quality":{"enum":["low","medium","high"],"type":"string","example":"high","description":"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."},"safe_mode":{"type":"boolean","default":true,"example":false,"description":"Whether to use safe mode. If enabled, this will blur images that are classified as having adult content."},"resolution":{"type":"string","example":"1K","maxLength":10,"minLength":1,"description":"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."},"aspect_ratio":{"enum":["auto","1:1","3:2","16:9","21:9","9:16","2:3","3:4","4:5"],"type":"string","example":"16:9","description":"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."},"output_format":{"enum":["jpeg","png","webp"],"type":"string","example":"png","description":"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."}},"description":"Edit an image by compositing up to three layered images with a single prompt. Supports base64-encoded strings and URLs.","additionalProperties":false},{"type":"object","properties":{"modelId":{"enum":["firered-image-edit","qwen-edit","qwen-edit-uncensored","grok-imagine-edit","grok-imagine-quality-edit","qwen-image-2-edit","qwen-image-2-pro-edit","wan-2-7-pro-edit","flux-2-max-edit","gpt-image-2-edit","gpt-image-1-5-edit","nano-banana-2-edit","nano-banana-pro-edit","seedream-v5-lite-edit","seedream-v4-edit"],"type":"string"}}}]},"responseSchema":{"type":"string","format":"binary"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S-tpll2R60FdDkSayX_2l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Edit or modify an image using up to three layered inputs (base image plus masks/overlays) with a text prompt.","exampleAgentPrompt":"Take this base image and this mask image, then remove the tree in the masked region and change the background sky to a sunset — output as a 16:9 PNG at 1K resolution.","exampleUseCases":null,"resultDescription":"A binary image file (JPEG, PNG, or WebP) containing the AI-edited result of the base image and any provided mask/overlay layers, modified according to the text prompt.","failureModes":["402 Payment Required — insufficient x402 wallet balance or invalid API key","400 Bad Request — images array is empty or exceeds 3 items, or image dimensions are out of range (must be between 65536 and 33177600 pixels)","400 Bad Request — prompt is empty or exceeds character limit","413 Payload Too Large — image file size exceeds 25MB","422 Unprocessable Entity — unsupported image format or malformed base64 string","500 Internal Server Error — model inference failure"],"whenToPreferThis":"Use this endpoint when you need to edit or modify an existing image using a text prompt and optionally one or two mask/overlay images. It is ideal for inpainting, background replacement, object removal, or compositing operations. Choose this over a text-to-image endpoint when you want to preserve and transform an existing image rather than generating one from scratch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T20:17:38.396Z","isFirstParty":false}