Vai al contenuto principale
Magic Edit prende un’immagine sorgente e un prompt e restituisce un’immagine modificata. Fornisci la sorgente in tre modi — un image_id già presente nel contesto della tua organizzazione (per esempio un file locale prima caricato), un url https, oppure base64 + mime_type inline. Aggiungi un mask per eseguire in modalità PRO (inpaint basato su mask) e riutilizza i tuoi modelli style/object/person/setting addestrati e le color palette per risultati in linea con il brand.

​
Pattern asincrono

Come la generazione, la modifica è asincrona: POST /images/edits restituisce 202 Accepted con un id del job; interroga GET /images/edits/{id} finché non è completed, poi leggi le immagini modificate (presigned URL validi per 24 ore). Un webhook_url ti dà invece una callback push — vedi Webhook.

​
Engine e credits

Passa engine per scegliere il modello di modifica; omettilo per usare quello predefinito, nano_banana_pro. Il rapporto d’aspetto della sorgente viene sempre mantenuto. Ogni regola qui sotto restituisce 422 (con param impostato sul campo) prima che venga addebitato qualsiasi credit:
  • Engine sconosciuto. Il messaggio elenca le cinque chiavi valide.
  • Risoluzione. 1K, 2K o 4K sui tre engine Nano Banana; se omessa vale 1K. gemini e kontext hanno una risoluzione fissa — un valore di resolution lì restituisce 422.
  • Mask. Un mask esegue la modifica in modalità PRO (basata su mask), supportata solo da nano_banana_pro e gemini.
  • Modelli addestrati e palette. style_id, object_ids, person_ids, setting_ids e color_palette_id funzionano solo con nano_banana_pro (engine indicato o omesso). Indicare un qualsiasi altro engine insieme a uno di essi restituisce 422 — l’engine non viene mai cambiato.
La risposta 202 riporta l’engine effettivo (quello che hai indicato, oppure nano_banana_pro) e la resolution effettiva (1K se omessa su un engine Nano Banana; null su gemini e kontext). num_images (1–4, predefinito 1) moltiplica il costo, e estimated_credits è l’importo dedotto. I costi vengono prelevati dal pool della tua organizzazione; un pool esaurito restituisce 402. Vedi Prezzi.