Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Das Bild, von dem aus es losgeht. |
mask_url | Nein | Übermale den Bereich, der sich ändern soll. |
output_format | Nein | Dateiformat des Ergebnisses. png · jpeg · webp · Standardwert: png |
prompt | Nein | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". |
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 | 4,5 | 0,045 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 5 Credits pro Bild (0,05 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Object Eraser 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/object-eraser-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/object-eraser-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 Object Eraser API
Was kostet die Object Eraser API?
Object Eraser kostet 5 Credits (0,05 $) 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 Object Eraser in der API?
Trag popnow/object-eraser-v1/edit für KI-Radierer im Feld model von POST /jobs/createTask ein.
Brauche ich eine Maske?
Nicht immer. Bei einem klar abgegrenzten Objekt mit etwas Freiraum drumherum reicht eine kurze Beschreibung; im Test verschwand eine Holzkelle allein per Text. Dünne Objekte und Dinge am Bildrand werden dagegen oft übersehen, und das Foto kommt unverändert zurück: Ein hohes Rack am Bildrand blieb bei zwei unterschiedlich formulierten Beschreibungen stehen und war mit einer Maske beim ersten Versuch weg. Senden Sie mask_url, wenn eine Beschreibung nicht greift oder wenn nur eines von zwei ähnlichen Objekten verschwinden soll.
Was passiert, wenn meine Beschreibung auf nichts passt?
Sie erhalten das Foto unverändert zurück, und die Anfrage gilt als abgeschlossen. Nennen Sie etwas, das wirklich im Bild ist, und ergänzen Sie eine Position, wenn es mehrfach vorkommt.
Wie soll die Maske aussehen?
So groß wie das Foto, weiß über dem, was verschwinden soll, und überall sonst schwarz. Malen Sie etwas über die Kante des Objekts hinaus, damit auch Umriss und Schatten verschwinden.
Kann das Werkzeug etwas Neues in die Lücke setzen?
Nein. Es entfernt und füllt die Stelle mit passender Umgebung.
Welche Limits hat die Object Eraser API?
Prompt-Länge (Zeichen): 1,000. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Object Eraser testen, ohne Code zu schreiben?
Ja. Der Playground führt Object Eraser mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.