# Guide: Editing

> Repair one thing without losing the rest.

1. **Lead with the operation** in the imperative: change, replace, remove,
   add, recolour, convert, place, extend `[vendor: Qwen edit rewriter]`.
2. **One attribute, pushed clearly.** Under-editing and leakage are the two
   failure modes `[vendor: Qwen]`. Budget two edit passes: the vendor's own
   blog example needed a second, more explicit pass `[vendor: Qwen]`.
3. **One blanket preservation clause**, and do not re-describe what stays:
   "a preservation description reads to the model as a generation
   instruction: the more concretely you describe something you meant to keep,
   the more likely it drifts" `[vendor: Qwen]`. Google's template:
   "Using the provided image, change only the [element] to [new]. Keep
   everything else in the image exactly the same, preserving the original
   style, lighting, and composition." `[vendor]`
4. **Name subjects specifically**, never pronouns: "the woman with short
   black hair", plus "preserve her facial features" `[vendor: BFL Kontext]`.
5. **Identity from a reference image**: point at the image by role rather than
   describing features `[vendor: Qwen]`. Multi-image: give each a role and say
   what is taken from where: "The person from image 1 is sitting in the cafe
   from image 2, wearing the outfit from image 3" `[vendor: BFL]`.
6. **Text edits:** `Replace "OLD" with "NEW", matching the original font,
   colour and placement` `[vendor: BFL]`.
7. **Style conversions:** "Convert to [style] while maintaining [what to
   preserve]" `[vendor: BFL]`.
8. **Sequential single edits** for big transformations; do not bundle
   `[vendor: BFL, Qwen]`. Do not fix what was not asked `[vendor: Qwen]`.
9. **Ratio:** output follows the input's ratio unless you ask to extend the
   canvas; say "outpaint/extend" explicitly `[vendor: Qwen]`. With several
   Gemini inputs the last image sets the ratio `[vendor: Google]`.
10. **Local repair vs regenerate:** repair when composition is right and the
    defect is local; regenerate when count, pose or blocking is wrong. Edits
    cannot restructure a scene `[community: T2I-Copilot, HandRefiner]`.
11. Bright coloured annotation boxes drawn on the input can target a local
    edit on Kontext `[vendor: BFL]`.

## Which model

| Need | Alias / model |
|---|---|
| Fast single-image edit | `edit:fast` → FLUX.1-Kontext-dev (1 ref) |
| Default edit | `edit:default` → Qwen-Image-Edit (1 ref, has negative_prompt) |
| Multi-reference composite | `edit:best` → FLUX-2-dev (4 refs) or FLUX-2-pro |
| Remove background | Bria/remove_background |
| Extend canvas | Bria/expand (aspect_ratio + prompt) |
| Erase object | Bria/erase |