Hintergrund entfernen API
PixMiller REST API · v1
Laden Sie ein Bild hoch; die KI entfernt den Hintergrund und gibt ein transparentes PNG zurück. Synchron — normalerweise wenige Sekunden.
POST
https://api.pixmiller.com/v1/remove
1
Authentifizierung & Anfrage
Senden Sie Ihren geheimen Schlüssel im
X-Api-Key: YOUR_API_KEY Anfrage-Header. Erstellen und verwalten Sie Schlüssel auf Ihrer Kontoseite.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
image_file
|
file | erforderlich* | Zu verarbeitendes Bild, Multipart-Upload. JPG / PNG / WebP, bis zu 20 MB |
image_url
|
string | erforderlich* | Oder eine öffentliche Bild-URL (geben Sie image_file oder image_url an) |
size
|
string | optional | Vorschau (kostenlos, mit Wasserzeichen) / full (HD, 1 Credit) / auto. Standard: Vorschau |
format
|
string | optional | auto (PNG wenn transparent, sonst JPG — Standard) / png / jpg |
bg_color
|
string | optional | Ergebnis-Hintergrund: transparent (Standard) / white (weiß) / beliebiger #RRGGBB-Wert |
2
Code-Beispiele
Wählen Sie eine Sprache und kopieren Sie — funktioniert sofort.1curl -X POST "https://api.pixmiller.com/v1/remove" \2 -H "X-Api-Key: YOUR_API_KEY" \3 -F "[email protected]" \4 -F "size=full"
1import requests23resp = requests.post(4 "https://api.pixmiller.com/v1/remove",5 headers={"X-Api-Key": "YOUR_API_KEY"},6 files={"image_file": open("product.jpg", "rb")},7 data={"size": "full"},8)9print(resp.json()["url"])
1import fs from "node:fs";23const form = new FormData();4form.append("image_file", new Blob([fs.readFileSync("product.jpg")]), "product.jpg");5form.append("size", "full");6const resp = await fetch("https://api.pixmiller.com/v1/remove", {7 method: "POST",8 headers: { "X-Api-Key": "YOUR_API_KEY" },9 body: form,10});11console.log((await resp.json()).url);
3
Antwort
1{2 "url": "https://cdn.pixmiller.com/result/8Kd2pQ.png"3}
url
Temporäre URL des verarbeiteten Bildes (das zugrunde liegende Bild wird nach 3 Tagen automatisch gelöscht).
4
Fehler
Fehler geben den passenden Statuscode und einen JSON-Body zurück in der Form {"errors":{"code":"…","message":"…"}}.
400
validation error
Fehlende oder ungültige image_file, Datei zu groß, oder widersprüchliche Bildquellen.
401
authentication_failed
Der X-Api-Key-Header fehlt oder ist ungültig.
402
not_enough_credit
size=full wurde angefordert, aber das Konto hat keine HD-Credits mehr.
422
invalid_image
Das Bild konnte nicht verarbeitet werden — zu klein, nicht unterstützt, oder Dekodierung fehlgeschlagen.
429
throttled
Ratenlimit überschritten. Verlangsamen und nach dem Retry-After-Header erneut versuchen.