mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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

3.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Заміна фону зображення суцільним кольором або градієнтом за допомогою ШІ.	930fe8890e55	human	6732f77d11df

Заміна фону

Заміна фону зображення суцільним кольором або градієнтом. Модель ШІ виявляє об'єкт, видаляє початковий фон і компонує об'єкт на обраному вами фоні.

Кінцева точка API

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

Приймає дані форми у форматі multipart із файлом зображення та полем JSON settings.

Параметри

Параметр	Тип	Обов'язковий	Типове значення	Опис
backgroundType	string	Ні	`"color"`	Режим фону: `color` або `gradient`
color	string	Ні	`"#ffffff"`	Шістнадцятковий колір фону (коли backgroundType має значення `color`)
gradientColor1	string	Ні	-	Перший шістнадцятковий колір градієнта
gradientColor2	string	Ні	-	Другий шістнадцятковий колір градієнта
gradientAngle	integer	Ні	`180`	Кут градієнта у градусах (0-360)
feather	integer	Ні	`0`	Радіус розмиття країв (0-20)
format	string	Ні	`"png"`	Вихідний формат: `png` або `webp`

Приклад запиту

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}'

Приклад відповіді

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

Відстежуйте перебіг через SSE за адресою GET /api/v1/jobs/{jobId}/progress. Після завершення завдання потік SSE видає подію completed з URL для завантаження.

Примітки

Це інструмент на основі ШІ, який повертає 202 Accepted і обробляється асинхронно. Підключіться до кінцевої точки SSE, щоб отримувати оновлення перебігу та кінцевий результат.
Потребує встановлення пакета функцій background-removal. Повертає 501, якщо пакет недоступний.
Вхідні дані HEIC, RAW, PSD та SVG автоматично декодуються перед обробкою.
Вихідний формат за замовчуванням PNG для збереження прозорості навколо об'єкта.

3.1 KiB Raw Blame History