Zamiana tła

Zamień tło obrazu na jednolity kolor lub gradient. Model AI wykrywa obiekt, usuwa oryginalne tło i komponuje obiekt na wybranym przez Ciebie tle.

Punkt końcowy API

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

Przyjmuje dane formularza multipart z plikiem obrazu oraz polem JSON settings.

Parametry

Parametr	Typ	Wymagany	Domyślnie	Opis
backgroundType	string	Nie	"color"	Tryb tła: color lub gradient
color	string	Nie	"#ffffff"	Kolor tła w formacie hex (gdy backgroundType to color)
gradientColor1	string	Nie	-	Pierwszy kolor gradientu w formacie hex
gradientColor2	string	Nie	-	Drugi kolor gradientu w formacie hex
gradientAngle	integer	Nie	180	Kąt gradientu w stopniach (0-360)
feather	integer	Nie	0	Promień wygładzania krawędzi (0-20)
format	string	Nie	"png"	Format wyjściowy: png lub webp

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Śledź postęp przez SSE pod GET /api/v1/jobs/{jobId}/progress. Po zakończeniu zadania strumień SSE emituje zdarzenie completed z adresem URL pobierania.

Uwagi

• To narzędzie wspomagane przez AI, które zwraca 202 Accepted i przetwarza asynchronicznie. Połącz się z punktem końcowym SSE, aby otrzymywać aktualizacje postępu i wynik końcowy.
• Wymaga zainstalowanego pakietu funkcji background-removal. Zwraca 501, jeśli pakiet nie jest dostępny.
• Dane wejściowe HEIC, RAW, PSD i SVG są automatycznie dekodowane przed przetworzeniem.
• Wynik domyślnie jest w formacie PNG, aby zachować przezroczystość wokół obiektu.