Bria
BRIA Eraser
bria-eraser
Ein Bildbearbeitungsmodell, spezialisiert auf Maskenradierung und Bereichsrekonstruktion: Es entfernt Zielobjekte anhand einer Schwarz-Weiß-Maske und ergänzt das Bild, wurde mit lizenzierten Daten trainiert und eignet sich für die Stapelbereinigung von E-Commerce- und Marketingmaterialien
Preise
bria-eraser per image
| Einzelpreis | $0.0575 |
|---|
Einordnung und Kurzprofil
BRIA Eraser ist ein Bildbearbeitungsmodell, das sich auf das Radieren spezialisiert: Es nimmt ein Originalbild und eine Schwarz-Weiß-Maske entgegen, wobei Weiß die zu entfernenden Bereiche markiert; das Modell entfernt das Zielobjekt und rekonstruiert die verdeckten Pixel und gibt ein sauberes Bild in der ursprünglichen Auflösung aus. Es eignet sich für Entwickler, die das Entfernen von Störobjekten und temporären Elementen in Batch-Content-Pipelines integrieren müssen, insbesondere für E-Commerce-, Werbe- und Konzeptdesignteams, die auf die Lizenzherkunft des Materials achten und Ergebnisse benötigen, die direkt veröffentlicht oder in den Postproduktions-Workflow übernommen werden können.
Kernhighlights
- Fokussiertes Radieren und Regionsrekonstruktion – macht nur eines: Ziele gemäß Maske entfernen und Hintergrund ergänzen; der Ablauf ist einfach und lässt sich leicht in bestehende Bildverarbeitungs-Pipelines integrieren.
- Ausgabe in ursprünglicher Auflösung – das Ergebnis übernimmt die Abmessungen des Eingabebilds; keine erneute Größenskalierung nötig, direkt für nachgelagertes Layout oder Veröffentlichungsprozesse verwendbar.
- Eingabebeschränkungen mit Fokus auf Nutzbarkeit – unterstützt öffentlich erreichbare JPEG-, PNG- und WEBP-Bilder sowie Schwarz-Weiß-Masken im gleichen Seitenverhältnis; der transparente Kanal kann per Parameter erhalten bleiben.
Funktionsbeschreibung
Maskengesteuertes Objektradieren: Mit einer Schwarz-Weiß-Maske im gleichen Seitenverhältnis wie das Originalbild wird das zu entfernende Objekt lokalisiert; Weiß ist der Radierbereich, Schwarz der beizubehaltende Bereich – ideal, um gezielte Elemente präzise aus dem Bild zu entfernen.
Pixelrekonstruktion im radierten Bereich: Für die entfernten Bereiche wird eine Inhaltsergänzung durchgeführt und die Hintergrundstruktur rekonstruiert, sodass nach dem Entfernen von Objekten keine auffälligen Lücken zurückbleiben und manuelle Nachbesserungen reduziert werden.
Ausrichtung der Ausgabauflösung: Die Ausgabe übernimmt die Auflösung des Eingabebilds; das Ergebnis kann das Originalmaterial direkt ersetzen und spart einen zweiten Skalierungs- und Ausrichtungsschritt.
Erhalt des transparenten Kanals: Bei aktiviertem preserve_alpha bleiben Eingaben mit Alpha-Kanal auch im Ergebnis transparent – geeignet für die Bereinigung von Overlay-Materialien.
Anpassung der Maskenherkunft: mask_type unterscheidet handgezeichnete Masken von Masken aus Segmentierungswerkzeugen, sodass automatische Segmentierungsergebnisse direkt in den Radier-Workflow übernommen werden können.
Anwendungsszenarien
- Entfernen von Störobjekten aus Produktbildern im E-Commerce – Produkthauptbild und eine Maske, die Störobjekte und temporäre Elemente markiert, einspielen und ein sauberes Produktbild erhalten, das direkt für Detailseiten und Regalplatzierung verwendet werden kann.
- Bildbereinigung in der Werbematerial-Nachbearbeitung – unerwünschte Objekte in Werbematerialien lokal radieren und ein fertiges Bild erhalten, das weiter layoutet und ausgeliefert werden kann, wodurch manuelle Retusche-Runden reduziert werden.
- Lokale Korrekturen im Konzeptdesign – Charakter-Originalzeichnungen oder Szenenskizzen mit lokaler Maske einspielen, überflüssige Striche oder Elemente entfernen und eine Grundlage ausgeben, auf der weiter ausgearbeitet werden kann.
- Batch-Content-Verarbeitungspipeline – automatisch segmentierte Masken im Batch in den Radierschritt einspeisen, bereinigte Materialien in einheitlicher Spezifikation erhalten und in bestehende Review- und Iterationsprozesse integrieren.
Einschränkungen und Auswahlhinweise
Die Qualität hängt stark von der Maskenqualität ab: Das Maskenverhältnis muss mit dem Originalbild übereinstimmen, und die Ränder sollten das Zielobjekt leicht überragen, sonst bleiben Reste zurück oder es wird versehentlich zu viel entfernt. Das Modell deckt nur Radieren und Regionsergänzung ab und bietet keine allgemeine Bildgenerierung; für Szenarien, die eine Neuerstellung aus dem Nichts erfordern, sollte ein anderes Modell gewählt werden. Außerdem werden nur öffentlich erreichbare Bild-URLs akzeptiert, und das Ergebnis behält die ursprüngliche Auflösung bei; für stark echtzeitkritische Aufrufszenarien ist es nicht geeignet.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell bria-eraser Masken-Radierer
Häufige Fragen
Alle Fragen ansehen →-
Wie zeichnet man eine Maske?
Eine Maske ist ein Schwarzweißbild: Weiße Bereiche werden gelöscht und der Hintergrund wird ergänzt, schwarze Bereiche bleiben unverändert. Der weiße Bereich sollte am besten etwas größer als der Objektrand sein, damit auch Schatten und Randreste mit entfernt werden.
-
Muss die Maske genauso groß sein wie das Originalbild?
Das Seitenverhältnis der Maske muss mit dem Originalbild übereinstimmen. Es wird empfohlen, direkt in der Größe des Originalbilds zu exportieren, um eine Verschiebung der Radierposition zu vermeiden.
-
Muss ich einen Prompt schreiben?
Nein. Bria Eraser arbeitet ausschließlich mit dem Originalbild und der Maske; das Feld prompt darf in der Anfrage nicht enthalten sein.
-
mask_type: manual oder automatic wählen?
Für Masken, die manuell mit einem Pinsel oder Bildbearbeitungsprogramm gemalt wurden, wählen Sie manual (Standard); für Masken, die automatisch von einem Segmentierungswerkzeug erzeugt wurden, wählen Sie automatic.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: bria-eraser
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für bria-eraser und Route default — siehe Parametertabelle unten.
mask_urlstringPflichtminLength 1pattern ^https?://Black-and-white mask with the same aspect ratio as the image: white marks what to erase, black is kept. Paint slightly beyond the object edge.
image_urlstringPflichtminLength 1pattern ^https?://Public URL of the image to clean up (JPEG, PNG or WEBP). The result keeps the original resolution.
mask_typestringOptionalStandard: "manual"manual for brush-drawn masks; automatic for masks produced by a segmentation tool.
manualautomaticpreserve_alphabooleanOptionalStandard: falseIf the input has an alpha channel, keep its transparency in the result.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bria-eraser",
"input": {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "bria-eraser",
input: {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "bria-eraser",
"input": {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Vergleichstest
Recraft v4.1 Flash 文生图横向对比:Entwickler-Auswahl und Migrationsleitfaden
Mit Kosten von $0,01 pro Bild und reiner Text-zu-Bild-Fähigkeit beurteilen, ob es zu Ihrer Bildgenerierungs-Pipeline passt
-
Tutorial
So rufen Sie kling-4.0/image-to-video auf HiAPI auf: curl, Python und Polling
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Vergleichstest
hailuo-2.3-fast/image-to-video im Quervergleich: Wie man Bild-zu-Video-Modelle auswählt und worauf bei der Migration zu achten ist
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Recraft Creative Upscale Recraft $0.357 /Bild -
Imagen 4 Google $0.030 /Bild -
FLUX 1.1 Pro Black Forest Labs $0.050 /Bild -
Krea 2 Medium Turbo Krea $0.021 /Bild -
Grok Imagine Image 2.0 xAI $0.052 /Bild -
Seedream 4.5 ByteDance $0.045 /Bild -
BRIA Product Shot Bria $0.058 /Bild -
Ideogram V4 Ideogram $0.050 /Bild -
FASHN Tryon v1.6 FASHN $0.107 /Bild -
FLUX.2 Black Forest Labs $0.035 /Bild -
Krea 3 Krea $0.036 /Bild -
Recraft Crisp Upscale Recraft $0.004 /Bild