Zum Hauptinhalt springen
Magic Edit nimmt ein Quellbild und einen Prompt und gibt ein bearbeitetes Bild zurück. Gib die Quelle auf drei Wegen an — eine image_id, die bereits im Kontext deiner Organisation liegt (zum Beispiel eine lokale Datei, die du zuerst hochgeladen hast), eine https-url oder inline base64 + mime_type. Füge eine mask hinzu, um im PRO-Modus (maskenbasiertes Inpainting) zu arbeiten, und nutze deine trainierten style/object/person/setting-Modelle und color palettes wieder, um markenkonforme Ergebnisse zu erhalten.

​
Asynchrones Muster

Wie die Generierung ist auch die Bearbeitung asynchron: POST /images/edits gibt 202 Accepted mit einer Job-id zurück; frage GET /images/edits/{id} ab, bis completed, und lies dann die bearbeiteten Bilder (presigned URLs, 24 Stunden gültig). Eine webhook_url liefert dir stattdessen einen Push-Callback — siehe Webhooks.

​
Engines und Credits

Übergib engine, um das Bearbeitungsmodell zu wählen; lass es weg, um die Standard-Engine nano_banana_pro zu verwenden. Das Seitenverhältnis der Quelle bleibt immer erhalten. Jede der folgenden Regeln liefert 422 (mit param auf dem Feld), bevor Credits abgebucht werden:
  • Unbekannte Engine. Die Meldung listet die fünf gültigen Keys.
  • Auflösung. 1K, 2K oder 4K auf den drei Nano-Banana-Engines; weggelassen bedeutet 1K. gemini und kontext haben eine feste Auflösung — ein resolution-Wert liefert dort 422.
  • Maske. Eine mask führt die Bearbeitung im PRO-Modus (maskenbasiert) aus, nur unterstützt von nano_banana_pro und gemini.
  • Trainierte Modelle und Paletten. style_id, object_ids, person_ids, setting_ids und color_palette_id funktionieren nur mit nano_banana_pro (genannte oder weggelassene engine). Nennst du zusammen mit einem davon eine andere Engine, liefert das 422 — die Engine wird nie gewechselt.
Die 202-Antwort gibt die effektive engine (die genannte oder nano_banana_pro) und resolution zurück (1K, wenn sie auf einer Nano-Banana-Engine weggelassen wird; null auf gemini und kontext). num_images (1–4, Default 1) vervielfacht die Kosten, und estimated_credits ist der abgebuchte Betrag. Die Kosten gehen aus dem Pool deiner Organisation; ein aufgebrauchter Pool liefert 402. Siehe Preise.