← Terug naar de tool

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.bgBGNinja
URLhttps://api.remove.bg/v1.0/removebghttps://bgninja.com/api/remove
Afbeeldingsveldimage_filefile
Achtergrondkleurbg_colorbg (6-cijferige hex, geen #; kleurnamen zoals white worden genegeerd en geven transparantie)
AuthenticatieX-Api-Key headergeen, laat de header achterwege
Uitvoergroottesize (credits per grootte)altijd je volledige resolutie, tot 30 MP
AntwoordPNG-bytesPNG-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

MethodePOST
URLhttps://bgninja.com/api/remove
Lichaammultipart/form-data
AuthenticatieGeen

Parameters.

NaamVereistWat het doet
filejaDe afbeelding. PNG, JPG, WEBP of HEIC.
bgneeHex-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.
srcneeEen 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 bestandsgrootte99 MB
Maximale resolutie30 megapixels
Gelijktijdig uitvoeren2 per IP-adres
Verzoeken per dag10 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.

StatusBetekenis
400Het bestand is geen afbeelding die we kunnen lezen. Het heeft een verkeerd formaat of de bytes zijn beschadigd.
402De 10 gratis verzoeken voor vandaag zijn opgebruikt. De teller wordt om middernacht gereset.
413Te groot. Het bestand is groter dan 99 MB of heeft meer dan 30 megapixels.
422Nee file veld in het verzoek. Deze komt terug onder een detail sleutel in plaats van error.
429Je 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/remove

Wat 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:

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.

ShinobiTools · KvK 42147182 · info@shinobitools.com