mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
2.2 KiB
2.2 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Ganti latar belakang gambar dengan warna solid atau gradien menggunakan AI. | 930fe8890e55 | human | 1aa421bb864f |
Ganti Latar Belakang
Ganti latar belakang gambar dengan warna solid atau gradien. Model AI mendeteksi subjek, menghapus latar belakang asli, dan menggabungkan subjek ke latar belakang pilihan Anda.
API Endpoint
POST /api/v1/tools/image/background-replace
Menerima data formulir multipart dengan berkas gambar dan bidang JSON settings.
Parameter
| Parameter | Tipe | Wajib | Bawaan | Deskripsi |
|---|---|---|---|---|
| backgroundType | string | Tidak | "color" |
Mode latar belakang: color atau gradient |
| color | string | Tidak | "#ffffff" |
Warna hex latar belakang (ketika backgroundType bernilai color) |
| gradientColor1 | string | Tidak | - | Warna hex gradien pertama |
| gradientColor2 | string | Tidak | - | Warna hex gradien kedua |
| gradientAngle | integer | Tidak | 180 |
Sudut gradien dalam derajat (0-360) |
| feather | integer | Tidak | 0 |
Radius pelunakan tepi (0-20) |
| format | string | Tidak | "png" |
Format keluaran: png atau webp |
Contoh Permintaan
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}'
Contoh Respons
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"async": true
}
Lacak progres melalui SSE di GET /api/v1/jobs/{jobId}/progress. Ketika pekerjaan selesai, aliran SSE memancarkan peristiwa completed dengan URL unduhan.
Catatan
- Ini adalah alat bertenaga AI yang mengembalikan
202 Accepteddan memproses secara asinkron. Sambungkan ke endpoint SSE untuk menerima pembaruan progres dan hasil akhir. - Memerlukan bundel fitur background-removal untuk dipasang. Mengembalikan
501jika bundel tidak tersedia. - Input HEIC, RAW, PSD, dan SVG didekode secara otomatis sebelum diproses.
- Keluaran bawaan ke PNG untuk mempertahankan transparansi di sekitar subjek.