Files
SnapOtter/apps/docs/pl/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.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Zamień tło obrazu na jednolity kolor lub gradient za pomocą AI. 930fe8890e55 human bb4f654dfdc7

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 "file=@photo.jpg" \
  -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.