Bild erweiternÜber Image Expander
Erweitern Sie ein Foto auf ein neues Seitenverhältnis: Um das Original herum wird neue Umgebung gemalt, statt es zu beschneiden oder zu strecken.
Du rufst es mit dem Modellnamen popnow/image-expander-v1/edit über POST /jobs/createTask auf, ab 4 Credits pro Bild (0,04 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.
Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
aspect_ratio | Nein | Die Form des Bildes: breit, quadratisch oder hoch. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · Standardwert: 1:1 |
image_url | Ja | Das Bild, von dem aus es losgeht. |
output_format | Nein | Dateiformat des Ergebnisses. png · jpeg · webp · Standardwert: png |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Bild | ≈ USD |
|---|---|---|
| Standard | 3,6 | 0,036 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 4 Credits pro Bild (0,04 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Image Expander API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model popnow/image-expander-v1/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/image-expander-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Image Expander API
Was kostet die Image Expander API?
Image Expander kostet 4 Credits (0,04 $) pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Image Expander in der API?
Trag popnow/image-expander-v1/edit für Bild erweitern im Feld model von POST /jobs/createTask ein.
Kann ich festlegen, was in der neuen Fläche erscheint?
Nein. Es gibt kein Prompt-Feld; die Erweiterung setzt fort, was schon im Foto ist.
Wie groß ist das Ergebnis?
Die lange Kante misst immer 1536 Pixel, die kurze folgt dem gewählten Format: 1536 × 864 bei 16:9, 864 × 1536 bei 9:16, 1536 × 1536 bei 1:1.
Welches Format soll ich wählen?
Das, das Ihr Ziel verwendet: 16:9 für Video-Cover und Header, 9:16 für Stories und Reels, 1:1 für Feeds und Marktplatzkacheln, 3:2 oder 2:3 für druckähnliche Layouts.
Welche Limits hat die Image Expander API?
Seitenverhältnisse: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Image Expander testen, ohne Code zu schreiben?
Ja. Der Playground führt Image Expander mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.