{"uid":"cap_wp8e_dfZRZKm8LAb7amc-","slug":"venice-ai-image-edit-621f61ca","name":"Venice AI Image Edit","description":"AI-powered image inpainting.","url":"https://api.venice.ai/api/v1/image/edit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"allOf":[{"type":"object","example":{"image":"iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB7GkOtAAAAIGNIUk0A...","prompt":"Colorize"},"required":["image","prompt"],"properties":{"image":{"anyOf":[{},{"type":"string"},{"type":"string","format":"uri"}],"description":"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."},"model":{"type":"string","default":"firered-image-edit","minLength":1,"description":"The model ID to use for image editing."},"prompt":{"type":"string","example":"Change the color of the sky to a sunrise","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","minLength":1,"deprecated":true,"description":"Deprecated: Use \"model\" instead. The model ID to use for image editing."},"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 input image when explicit sizing is required by the model. Supported values vary by model - check GET /api/v1/models for model-specific options."},"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 based on the supplied prompt.","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_oxfMpclO-jjsKHefxSBxH","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 existing image based on a text prompt, returning the modified image as binary output.","exampleAgentPrompt":"Take this product photo (attached) and change the background to a white studio setting, output as a 1:1 square PNG at 1K resolution using the firered-image-edit model.","exampleUseCases":null,"resultDescription":"A binary image file in the requested format (jpeg, jpg, png, or webp) containing the edited version of the input image, with modifications applied as directed by the text prompt.","failureModes":["Image too small (must be at least 65536 pixels) — 400 error","Image too large (exceeds 33177600 pixels or 25MB) — 400 error","Invalid aspect_ratio enum value — 400 error","Prompt exceeds model-specific character limit — 400 error","Insufficient wallet balance when using x402 — 402 Payment Required with top-up instructions","Unsupported model ID — 400 or 404 error","Unsafe content detected in safe_mode — blurred output returned","Model does not support requested resolution tier — 400 error"],"whenToPreferThis":"Use this endpoint when you have an existing image that needs to be modified, retouched, or transformed based on a textual description. Prefer this over image generation when the output must preserve key elements of the source image (composition, subject, structure) while applying targeted edits. Choose this over the Upscale endpoint when the goal is semantic modification rather than resolution enhancement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:19.369Z","isFirstParty":false,"canonicalSlug":"venice-ai-image-edit-621f61ca"}