Files
SnapOtter/apps/docs/nl/tools/image/background-replace.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.4 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Vervang de achtergrond van een afbeelding door een effen kleur of verloop met behulp van AI. 930fe8890e55 human f9b03df0551e

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.