Edit with Paint lets you mark a region on an existing image and prompt a change — “replace the dress with a red one,” “remove the background object,” “swap shoes.” Beta. Tracked as processing, not a fresh generation. URL: /app/Creative/edit (also /app/Creative/edit-image; the API normalizes both to edit).
Inputs and limits
- edit: 2–7 images (≥2: original + paint mask, plus optional context photos).
- edit-by-prompt: 1–2 images.
- Per file: ≤ 60 MB. Total request: ≤ 200 MB.
How paint masks work
A paint mask is a black/white image where the white region marks the area you want changed. Apiway sends the original + the mask + your prompt to the underlying model and returns the edited image. Paint mask precision matters: a clean, feathered mask produces clean edits.
Cost
Standard generation cost (no separate Edit pricing). Tracked in generation_events as processing for analytics, separate from catalog/lifestyle generations.
When to use Edit vs other templates
- Use Edit for surgical changes to an existing image (swap a color, fix a detail, remove an object).
- Use White Studio / Image Creation when you want a fresh image, not a tweak.
- Use Post Production Filters for global tonal adjustments without spending credits (client-side).