Passer au contenu principal
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 (par exemple un fichier local uploadé au préalable), 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} 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.

​
Engines et credits

Passe engine pour choisir le modèle d’édition ; omets-le pour utiliser celui par défaut, nano_banana_pro. Le ratio de l’image source est toujours conservé. Chaque règle ci-dessous renvoie 422 (avec param réglé sur le champ) avant tout débit de credits :
  • Engine inconnu. Le message liste les cinq clés valides.
  • Résolution. 1K, 2K ou 4K sur les trois engines Nano Banana ; omise, elle vaut 1K. gemini et kontext ont une résolution fixe — une valeur de resolution y renvoie 422.
  • Masque. Un mask exécute l’édition en mode PRO (basé sur un masque), pris en charge uniquement par nano_banana_pro et gemini.
  • Modèles entraînés et palettes. style_id, object_ids, person_ids, setting_ids et color_palette_id ne fonctionnent qu’avec nano_banana_pro (engine nommé ou omis). Nommer un autre engine avec l’un d’eux renvoie 422 — le engine n’est jamais changé.
La réponse 202 renvoie en écho le engine effectif (celui que tu as nommé, ou nano_banana_pro) et la resolution effective (1K si omise sur un engine Nano Banana ; null sur gemini et kontext). num_images (1–4, par défaut 1) multiplie le coût, et estimated_credits est le montant débité. Les coûts puisent dans le pool de ton organisation ; un pool épuisé renvoie 402. Voir Tarifs.