openclip-remove-background

OpenClip: Hintergrundentfernung

remove_background nimmt ein Bild entgegen und gibt eine transparente PNG mit entferntem Hintergrund zurück. Es ist KOSTENLOS, erfordert ein OpenClip-Konto, aber kein Abonnement und keine Credits. Es gibt keine Parameter zum Einstellen – ein einziger Aufruf erledigt die gesamte Arbeit.

Einrichtung (einmalig)

OpenClip ist ein entfernter MCP-Server unter https://openclip.app/mcp. Melde dich mit deinem OpenClip-Konto an, wenn die OAuth-Aufforderung erscheint – es gibt keinen API-Schlüssel zum Kopieren.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, dann /mcp zur Autorisierung.
• Claude Desktop / Web: Einstellungen, Verbindungen, „Benutzerdefinierten Connector hinzufügen“, URL einfügen, anmelden.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Nur-Header-Clients: Erstelle ein MCP-Token unter openclip.app/settings/connect und verbinde dich mit https://openclip.app/mcp/key unter Verwendung von Authorization: Bearer <token>.

Kurzer Test: Rufe get_account auf.

Der Ablauf

1. Hochladen. create_upload(filename, content_type) gibt eine id und eine upload_url zurück. Sende die rohen Bytes per PUT an upload_url und übergib dann die id als file. Rufe NICHT complete_upload auf, da dies die kostenpflichtige Freistellungs-Pipeline startet. Kostenlose Tools lesen die hochgeladene Datei direkt.
2. Aufruf. remove_background(file). Keine weiteren Parameter.
3. Abruf. Liefert einen tool_job-Hash. Rufe get_tool_job_status(tool_job) alle 5 bis 10 Sekunden auf. queued / processing bedeuten, dass der Vorgang noch läuft, completed gibt eine permanente CDN- outputs-URL für die transparente PNG zurück, failed liefert error.
4. PNG-URL zurückgeben. Das Bild ist transparent, daher wird es in manchen Vorschauen wie ein Schachbrett oder mit schwarzem Hintergrund aussehen. Das ist beabsichtigt – der Alphakanal ist vorhanden.

Regeln

• Frage immer ab – das Tool arbeitet asynchron.
• Die Ausgabe ist immer PNG. Transparenz benötigt einen Alphakanal, daher ist JPG keine Option. Falls der Benutzer das Bild nachträglich auf eine Farbe legen oder die Größe ändern möchte, verwende die Kette über edit_image (siehe openclip-thumbnails).
• Ausgabe-URLs sind permanente CDN-Links, weder signiert noch befristet.
• Die kostenlose Nutzung ist pro Tag ratenbegrenzt und unterliegt einer Dateigrößenbeschränkung. Die Fehlermeldung erklärt, wie ein Limit aufgehoben werden kann.

Beispiele: Aufforderungen zu Aktionen

• „Entferne den Hintergrund von diesem Foto“ – create_upload, PUT Bytes, remove_background(file), abfragen, die transparente PNG-URL zurückgeben.
• „Schneide das Produkt für einen Listing-Eintrag aus“ – gleicher Vorgang, dann edit_image(file, operation="resize", ...) auf der Ausgabe, falls bestimmte Maße benötigt werden.
• „Ich brauche dieses Logo auf transparentem Hintergrund“ – gleicher Vorgang, dann die PNG zurückgeben.

Verwandtes

Bilder zuschneiden, skalieren und formatieren übernimmt openclip-thumbnails (edit_image). Ein Einzelbild aus einem Video zu extrahieren, um es freizustellen, erfolgt ebenfalls mit openclip-thumbnails (extract_thumbnails).