Achtergrond vervangen

Vervang de achtergrond van een afbeelding door een effen kleur of verloop. Het AI-model detecteert het onderwerp, verwijdert de originele achtergrond en plaatst het onderwerp op de door jou gekozen achtergrond.

API-endpoint

POST /api/v1/tools/image/background-replace

Accepteert multipart form data met een afbeeldingsbestand en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
backgroundType	string	Nee	"color"	Achtergrondmodus: color of gradient
color	string	Nee	"#ffffff"	Hex-kleur van de achtergrond (wanneer backgroundType color is)
gradientColor1	string	Nee	-	Eerste hex-kleur van het verloop
gradientColor2	string	Nee	-	Tweede hex-kleur van het verloop
gradientAngle	integer	Nee	180	Verloophoek in graden (0-360)
feather	integer	Nee	0	Straal voor het verzachten van randen (0-20)
format	string	Nee	"png"	Uitvoerformaat: png of webp

Voorbeeldaanvraag

curl -X POST http://localhost:1349/api/v1/tools/image/background-replace \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"backgroundType": "color", "color": "#2563eb", "feather": 2}'

Voorbeeldantwoord

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Volg de voortgang via SSE op GET /api/v1/jobs/{jobId}/progress. Wanneer de taak is voltooid, zendt de SSE-stream een completed-gebeurtenis uit met de download-URL.

Opmerkingen

• Dit is een AI-gestuurde tool die 202 Accepted retourneert en asynchroon verwerkt. Maak verbinding met het SSE-endpoint om voortgangsupdates en het eindresultaat te ontvangen.
• Vereist dat de feature-bundel background-removal is geïnstalleerd. Retourneert 501 als de bundel niet beschikbaar is.
• HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór de verwerking.
• De uitvoer is standaard PNG om de transparantie rond het onderwerp te behouden.