Anleitung: Bilder erzeugen und bearbeiten

Bilder aus Text erzeugen, Fotos mit Referenzbildern bearbeiten und die Werkzeuge für Hintergrund, Hochskalieren und Retusche nutzen – mit Modellwahl und Kosten.

Bilder sind am schnellsten und günstigsten zu erzeugen und deshalb der beste Einstieg in die API. Die meisten Bildmodelle sind in unter einer Minute fertig, du kannst also ?wait=60 nutzen und bekommst das Bild in derselben Antwort.

Text zu Bild

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "black-forest-labs/flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Product photo of a ceramic coffee mug on a linen tablecloth, soft window light, shallow depth of field",
      "aspect_ratio": "4:3"
    }
  }'

Das Ergebnis steht in data.output.assets[0].url. Kommt stattdessen ein 202, hat das Modell länger als 60 Sekunden gebraucht; lies den Task dann mit recordInfo.

Welches Modell

Du willst	Probier	Warum
Die schnellsten, günstigsten Entwürfe	`alibaba/z-image-turbo/text-to-image`	Etwa zehn Sekunden und ein, zwei Credits pro Bild
Gute Allround-Qualität zum kleinen Preis	`black-forest-labs/flux-2-klein-9b/text-to-image`	Schnell, scharf, folgt Prompts gut
Lesbare Schrift, Poster, Diagramme	`google/nano-banana-2.1/text-to-image`, `openai/gpt-image-2/text-to-image`	Stark bei Schrift und Layout; bis 4K
Mehrere Varianten in einem Aufruf	Modelle mit `num_outputs`	Ein Task, mehrere Bilder

Preise hängen von Modell und Option ab. Modelle nennt den Einstiegspreis jedes Modells; seine Referenzseite listet alle Stufen.

Mit Referenzbildern bearbeiten

Bearbeitungsmodelle enden auf /edit und nehmen die Ausgangsbilder in image_urls, in der Reihenfolge, in der dein Prompt sie nennt:

{
  "model": "google/nano-banana-2.1/edit",
  "input": {
    "prompt": "Turn the scene into a bright summer afternoon and keep the composition",
    "image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"]
  }
}

Sag, was gleich bleiben soll, nicht nur, was sich ändert – Bearbeitungsmodelle nehmen „Gesicht und Pose beibehalten“ wörtlich.
Bei mehreren Referenzen nenn sie nach Position: „Zieh der Person im ersten Bild die Jacke aus dem zweiten an.“
Lokale Dateien gehen erst über einen Upload; wiederverwendete Dateien gehören in deine Asset-Bibliothek.

Werkzeuge mit einem Schritt

Die Werkzeuge von PopNow selbst nehmen ein einzelnes Bild und brauchen keinen Prompt:

Modell-ID	Funktion
`popnow/background-remover-v1/edit`	Stellt das Motiv frei, auf transparentem Hintergrund
`popnow/image-upscaler-v1/upscale`	Vergrößert und schärft ein Bild
`popnow/object-eraser-v1/edit`	Entfernt ein Objekt, das du markierst
`popnow/image-expander-v1/edit`	Erweitert das Bild über seine Ränder hinaus

{ "model": "popnow/background-remover-v1/edit",
  "input": { "image_url": "https://media.popnow.ai/movie/lighthouse.webp" } }

Einstellungen, auf die es ankommt

aspect_ratio und resolution verändern den Preis am häufigsten. Frag im Zweifel jobs/quote.
seed: Lässt du ihn weg, wird ein zufälliger gewählt und im input des Tasks zurückgegeben. Schick diese Zahl zurück, um eine nahe Variante eines gelungenen Ergebnisses zu bekommen; ein fester Seed macht Läufe vergleichbar, verspricht aber kein identisches Bild.
output_format: png erhält Transparenz und Details; jpeg ist kleiner.
Unbekannte Einstellungen werden abgelehnt – sieh ins Schema des Modells, statt Einstellungen von einem anderen Modell zu übernehmen.

Prompts, die funktionieren

Beschreib das Bild so, wie du eine Fotografin oder einen Illustrator briefen würdest: Motiv, Umgebung, Bildaufbau, Licht, Stil. „Eine Keramiktasse, von oben, auf Leinen, Morgenlicht vom Fenster, gedämpfte Farben“ schlägt „ein schönes Tassenfoto“. Stell das Wichtigste an den Anfang und vermeide lange Listen von Stilwörtern, die in verschiedene Richtungen ziehen.

Fehler, die dir begegnen können

content_rejected – das Modell hat den Prompt oder die Referenz abgelehnt. Formulier um oder probier ein anderes Modell.
invalid_asset – eine Referenz ließ sich nicht lesen. Prüf, ob die URL das Bild selbst liefert, oder lade die Datei hoch.
unsupported_combination – dieses Modell kann diese Kombination gerade nicht; ändere die Einstellung aus der Meldung.

Alle geben die Reservierung frei, ein gescheitertes Bild kostet also nichts.