Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Das Bild, von dem aus es losgeht. |
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 | 0,72 | 0,0072 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 1 Credit pro Bild (0,01 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Background Remover 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/background-remover-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/background-remover-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 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 Background Remover API
Was kostet die Background Remover API?
Background Remover kostet 1 Credit (0,01 $) 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 Background Remover in der API?
Trag popnow/background-remover-v1/edit für Hintergrund entfernen im Feld model von POST /jobs/createTask ein.
Muss ich das Motiv beschreiben?
Nein. Der Endpunkt nimmt ein einziges Feld, image_url, und bestimmt den Vordergrund selbst. Sind mehrere Kandidaten im Bild, schneiden Sie es vorher auf den gewünschten zu.
Was bekomme ich zurück?
Ein PNG mit transparentem Hintergrund, in derselben Breite und Höhe wie das gesendete Bild, sodass Sie es direkt wieder über das Original legen können.
Kann das Werkzeug einen neuen Hintergrund einsetzen?
Nicht im selben Aufruf, es entfernt nur. Legen Sie das PNG auf Ihre eigene Farbe oder Ihr eigenes Foto, oder bauen Sie mit Image Expander eine neue Szene und legen Sie den Freisteller darüber.
Welche Fotos eignen sich am besten?
Fotos mit einem klaren Motiv, das sich in Farbe oder Licht von der Umgebung abhebt. Kontrastarme Kanten, Bewegungsunschärfe und vom Bildrand angeschnittene Motive sind die Stellen, an denen Freisteller verrutschen.
Kann ich Background Remover testen, ohne Code zu schreiben?
Ja. Der Playground führt Background Remover mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.