API voor achtergrondverwijdering
Verwijdert de achtergrond van een afbeelding en geeft een transparante PNG terug. Geen API-sleutel nodig. Geen account vereist. Eén POST met een afbeelding is de volledige aanroep: je hoeft je nergens voor te registreren en nergens op te wachten. Het is een gratis API om de achtergrond te verwijderen: een API-aanroep voor het verwijderen van de achtergrond die werkt via curl, Python, Node of alles wat een HTTP POST kan verzenden.
Laatst bijgewerkt: 28 september 2026
Dit is dezelfde technologie die BGNinja-website werkt via een directe HTTP-verbinding. Het gebruik is gratis, binnen de hieronder vermelde limieten. Je hoeft geen toegang aan te vragen en er is geen sleutel die je moet rouleren.
Snel aan de slag
curl -s -o output.png \
-F "file=@input.jpg" \
https://bgninja.com/api/remove
Dat is alles. output.png het resultaat is een afbeelding waarbij de achtergrond is verwijderd en een transparante laag (alpha-kanaal) is toegevoegd op de plek waar de achtergrond zich bevond.
Overstappen van de remove.bg API?
Op de API-pagina van remove.bg staat dat Vanaf 1 december 2026 verhuist achtergrondverwijdering naar Leonardo.Ai. Als je liever niet ergens een nieuw account aanmaakt, is de overstap naar BGNinja klein:
| remove.bg | BGNinja | |
|---|---|---|
| URL | https://api.remove.bg/v1.0/removebg | https://bgninja.com/api/remove |
| Afbeeldingsveld | image_file | file |
| Achtergrondkleur | bg_color | bg (6-cijferige hex, geen #; kleurnamen zoals white worden genegeerd en geven transparantie) |
| Authenticatie | X-Api-Key header | geen, laat de header achterwege |
| Uitvoergrootte | size (credits per grootte) | altijd je volledige resolutie, tot 30 MP |
| Antwoord | PNG-bytes | PNG-bytes, dezelfde verwerking |
Twee verschillen: de gratis limiet is hier 10 afbeeldingen per dag per IP-adres, en er is geen invoer voor afbeelding-URL's. Stuur het bestand zelf. Als je grote volumes verwerkt, laat het ons dan weten op de contactpagina als eerste. Bekijk voor losse foto's in de browser de remove.bg-alternatief pagina en wat de sluiting van remove.bg betekent.
Eindpunt
| Methode | POST |
|---|---|
| URL | https://bgninja.com/api/remove |
| Lichaam | multipart/form-data |
| Authenticatie | Geen |
Parameters.
| Naam | Vereist | Wat het doet |
|---|---|---|
file | ja | De afbeelding. PNG, JPG, WEBP of HEIC. |
bg | nee | Hex-kleur zonder de #bijvoorbeeld ffffff. Plaatst de uitgesneden afbeelding over de effen achtergrondkleur in plaats van deze transparant te laten. Laat dit weg om de afbeelding transparant te maken. |
src | nee | Een label om je app te identificeren, bijvoorbeeld my-pluginMaximaal 32 tekens, letters, cijfers en koppeltekens. Dit is puur bedoeld om te zien welke integraties worden gebruikt. Al het andere wordt genegeerd. |
Antwoord
Als het lukt, krijg je HTTP 200 en de onbewerkte bytes van een PNG-bestand, inclusief Content-Type: image/pngDe aanroep is synchroon: er is geen taak-ID, geen wachtrij en er is niets om te pollen. Schrijf de body rechtstreeks naar een bestand of geef hem door aan je afbeeldingsbibliotheek.
Limieten
| Maximale bestandsgrootte | 99 MB |
|---|---|
| Maximale resolutie | 30 megapixels |
| Gelijktijdig uitvoeren | 2 per IP-adres |
| Verzoeken per dag | 10 gratis, wordt elke nacht om 0.00 uur gereset |
Dit zijn de werkelijke limieten en deze worden gehandhaafd. Er is geen verborgen onbeperkte versie en het gratis resultaat is de afbeelding in volledige resolutie, geen verkleinde voorvertoning.
Fouten
Een foutmelding wordt als JSON teruggestuurd, met één enkel error Gebruik een sleutel, niet een afbeelding. Controleer de statuscode voordat je de inhoud naar een bestand schrijft.
| Status | Betekenis |
|---|---|
400 | Het bestand is geen afbeelding die we kunnen lezen. Het heeft een verkeerd formaat of de bytes zijn beschadigd. |
402 | De 10 gratis verzoeken voor vandaag zijn opgebruikt. De teller wordt om middernacht gereset. |
413 | Te groot. Het bestand is groter dan 99 MB of heeft meer dan 30 megapixels. |
422 | Nee file veld in het verzoek. Deze komt terug onder een detail sleutel in plaats van error. |
429 | Je hebt al twee verzoeken lopen vanaf dit adres. Wacht tot er een is voltooid en probeer het opnieuw. |
$ curl -s -F "file=@notes.txt" https://bgninja.com/api/remove
{"error":"can't read this file (TXT), please upload a photo (JPG, PNG, WEBP, HEIC)."}
A 429 gaat over hoeveel er tegelijk draaien, dus probeer dezelfde afbeelding kort daarna opnieuw. Een 402 is de dagelijkse telling, dus opnieuw proberen voor middernacht heeft geen zin.
Voorbeelden
Python
import requests
with open("input.jpg", "rb") as f:
r = requests.post(
"https://bgninja.com/api/remove",
files={"file": f},
data={"src": "my-app"},
timeout=120,
)
r.raise_for_status()
open("output.png", "wb").write(r.content)
Node.
import { readFile, writeFile } from "node:fs/promises";
const body = new FormData();
body.append("file", new Blob([await readFile("input.jpg")]), "input.jpg");
body.append("src", "my-app");
const r = await fetch("https://bgninja.com/api/remove", { method: "POST", body });
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await writeFile("output.png", Buffer.from(await r.arrayBuffer()));
Een effen witte achtergrond in plaats van transparantie
curl -s -o output.png \
-F "file=@input.jpg" \
-F "bg=ffffff" \
https://bgninja.com/api/removeWat er met je afbeelding gebeurt
De afbeelding wordt in het geheugen verwerkt en direct naar je teruggestreamd. Er wordt niets op de schijf geschreven, dus er is geen opgeslagen kopie die ergens ligt en wacht om te worden verwijderd of gelekt. We houden een telling bij van het aantal ontvangen aanvragen en hun grootte, en verder niets dat de afbeelding zelf identificeert.
Gebruik in je eigen project
Je bent welkom om hierop voort te bouwen, ook in iets waarvoor je geld vraagt. Eén voorwaarde en één verzoek:
- geef a door
srclabel, zodat we kunnen zien dat er een integratie bestaat en voorkomen dat deze kapot gaat. - Voorwaarde: als je BGNinja gebruikt op een website of in een app die andere mensen gebruiken, noem ons dan (“Background removal by BGNinja”, met een link naar bgninja.com) ergens waar gebruikers het kunnen zien, zoals in de footer of op een credits-pagina. Dit is de enige reden waarom we dit gratis en zonder sleutel kunnen houden. Voor gebruik op je eigen bestanden is geen naamsvermelding nodig.
Als je van plan bent om er veel data doorheen te sturen, neem dan contact op via contactpagina eerst. We horen liever van u dan dat we u afremmen.
Vragen
Is dit een vervanging voor de remove.bg API?
Ja. De API van remove.bg verhuist op 1 december 2026 naar Leonardo.Ai. Hier wijzig je de URL in https://bgninja.com/api/remove, hernoem je image_file naar file en bg_color naar bg, en laat je de header X-Api-Key weg. De gratis limiet is 10 afbeeldingen per dag.
Heb ik een API-sleutel nodig?
Nee. Er is geen sleutel, geen account en u hoeft zich niet te registreren. Het eindpunt is open.
Is het echt gratis?
Ja, binnen de bovengenoemde limieten. Het is geen proefversie en je hoeft geen betaalgegevens op te geven. De optionele pas verhoogt de limieten voor de website; de hier vermelde API-limieten zijn van toepassing op alle gebruikers.
Is er een dagelijkse limiet?
Je kunt 10 verzoeken per dag doen met de gratis versie; de limiet wordt elke nacht om 0.00 uur gereset. De enige andere beperking is dat je maximaal 2 verzoeken tegelijk vanaf hetzelfde IP-adres kunt doen.
Kan ik het uitsnijmasker krijgen in plaats van de afbeelding?
Niet vandaag. De functie retourneert de samengestelde PNG-afbeelding. Als u de maskerafbeelding apart nodig heeft, laat het ons dan weten via contactpagina en dan nemen wij het in behandeling.
Zal dit eindpunt blijven werken?
Het is hetzelfde eindpunt dat onze eigen website gebruikt, dus het zal niet zomaar verdwijnen. Als de vorm van het verzoek ooit moet worden gewijzigd, blijft de oude vorm naast de nieuwe versie werken.
Is het antwoord asynchroon?
Nee. Het verzoek is synchroon; de HTTP-antwoordtekst is de voltooide PNG-afbeelding. Er is geen taak-ID en er is niets om te pollen.
Welke afbeeldingsformaten worden geaccepteerd?
PNG, JPG, WEBP en HEIC kunnen worden gebruikt. Een PNG met een alfakanaal wordt als resultaat gegeven, of een effen achtergrond als je een hexkleur opgeeft in de parameter bg.
Wat gebeurt er met de afbeelding die ik verstuur?
De gegevens worden direct in het geheugen verwerkt en vervolgens weer teruggegeven. Er wordt niets op de harde schijf opgeslagen, dus er is geen kopie die je hoeft te verwijderen.
Wat gebeurt er als ik te veel verzoeken verstuur?
Een derde verzoek dat tegelijkertijd vanaf één IP-adres wordt gestart, krijgt HTTP 429: wacht tot er één klaar is en probeer het opnieuw. Na 10 verzoeken op een dag krijg je HTTP 402 tot middernacht.
De gebruiksvoorwaarden zijn te vinden op voorwaardenpaginaen wat we met de gegevens doen, staat op privacybeleid.