> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Édition d'images

> Édite une image existante avec un prompt — avec ou sans masque — en réutilisant tes modèles entraînés.

Magic Edit prend une image source et un prompt et renvoie une image éditée. Fournis
la source de trois façons — un `image_id` déjà présent dans le contexte de ton
organisation, une `url` `https`, ou du `base64` inline + `mime_type`. Ajoute un
`mask` pour passer en mode **PRO** (inpaint basé sur un masque), et réutilise tes
modèles `style`/`object`/`person`/`setting` entraînés ainsi que tes palettes de
couleurs pour des résultats à ta charte.

## Modèle asynchrone

Comme la génération, l'édition est asynchrone : `POST /images/edits` renvoie
**`202 Accepted`** avec un `id` de job ; interroge
[`GET /images/edits/{id}`](/fr/api-reference/edits/get-edit) jusqu'à `completed`,
puis lis les images éditées (presigned URLs valables **24 heures**). Un
`webhook_url` te donne à la place un callback push — voir
[Webhooks](/fr/guides/webhooks).

## Engines et credits

Le engine par défaut est `nano_banana_pro` ; `gemini` et `kontext` sont également
disponibles. Fournir un `mask` exécute l'édition en mode **PRO** (basé sur un
masque), pris en charge par les engines `nano_banana_pro` et `gemini`. Fournir des
modèles entraînés (`style_id`/`object_ids`/`person_ids`/`setting_ids`) ou un
`color_palette_id` force `nano_banana_pro`. Chaque sortie (output) est facturée
depuis le pool de ton organisation aux tarifs de l'app ; un pool épuisé renvoie
`402`. Voir [Tarifs](/fr/guides/pricing).