API bgCut.net

Hapus latar belakang dari aplikasi, toko, atau pipeline Anda sendiri dengan satu permintaan HTTPS.

URL dasar: https://bgcut.net/api/v1 · Dapatkan kunci Anda di Kunci API.

Autentikasi

Setiap permintaan harus menyertakan kunci API Anda di header X-Api-Key. Kunci dibuat dan dicabut di akun Anda; setiap kunci dapat diberi nama agar Anda dapat merotasinya per aplikasi.

X-Api-Key: bgc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Atau, kirimkan sebagai token Bearer: Authorization: Bearer bgc_…

POST /remove

Kirim gambar sebagai file multipart, sebagai URL, atau dalam enkode base64. Secara default, respons berupa gambar hasil (biner).

Parameter

ParameterJenisDeskripsi
image_filefileFile gambar (multipart/form-data). JPG, PNG, WebP, GIF, BMP, TIFF; maks. 25 MB / 30 MP.
image_urlstringURL publik gambar yang akan diambil sebagai pengganti unggahan.
image_file_b64stringGambar dalam enkode base64 (opsional dengan awalan data:).
sizeauto | preview | fullpreview = hingga 640 px (menggunakan kuota bulanan gratis Anda, tanpa kredit); full = resolusi asli (1 kredit); auto (default) = full jika Anda memiliki kredit, jika tidak, preview.
formatpng | jpg | webpFormat keluaran. png mempertahankan transparansi; jpg diratakan di atas bg_color (default putih).
modelfast | hq | portraitfast (default, ~1 dtk), hq (kualitas lebih tinggi, lebih lambat), portrait (dioptimalkan untuk orang).
bg_colorstringWarna heksadesimal untuk latar belakang, mis. #ffffff. Kosongkan untuk latar transparan.
bg_blurnumberPertahankan latar belakang asli, tetapi buramkan dengan radius ini dalam piksel (1–200), misalnya 25 untuk tampilan mode potret. Menggantikan bg_color.
cropbooleanPangkas keluaran sesuai kotak pembatas subjek.
crop_marginintegerMargin tambahan dalam piksel di sekitar subjek saat memangkas (0–200).
roistringArea fokus (region of interest) sebagai pecahan x,y,w,h (0–1). AI hanya memproses bagian di dalam persegi panjang ini; semua yang berada di luarnya menjadi transparan.
feathernumberHaluskan tepi dengan radius ini dalam piksel (0–5).
qualityintegerKualitas JPG/WebP 50–100 (default 92).
responsebinary | jsonbinary (default) mengembalikan gambar; json mengembalikan metadata beserta gambar base64.

Respons

Permintaan yang berhasil mengembalikan HTTP 200 dengan byte gambar dan header berikut:

HTTP/1.1 200 OK
Content-Type: image/png
X-Credits-Charged: 1
X-Credits-Remaining: 149
X-Free-Remaining: 5
X-Width: 3000
X-Height: 2000
X-Image-Id: 1f3a…
X-Type: hd

Dengan response=json, Anda akan mendapatkan:

{
  "ok": true,
  "image": { "id": "1f3a…", "width": 3000, "height": 2000, "format": "png", "type": "hd", "bytes": 812345, "bbox": [120, 40, 2810, 1990], "data": "iVBORw0KGgo…" },
  "credits_charged": 1,
  "credits_remaining": 149,
  "free_remaining": 5
}

GET /account

curl https://bgcut.net/api/v1/account -H "X-Api-Key: bgc_…"

{ "ok": true, "email": "[email protected]", "credits": 149, "free_remaining": 5, "free_per_month": 5, "free_max_width": 640, "rate_limit_per_minute": 60 }

GET /images

Mengembalikan 100 gambar terakhir yang diproses dengan kunci API Anda, termasuk URL editor untuk menyempurnakannya di browser.

Galat

Error dikembalikan dalam format JSON berisi kode error dan pesan yang mudah dibaca:

{ "ok": false, "error": "insufficient_credits", "message": "No credits left. Buy credits at https://bgcut.net/pricing or request size=preview." }
HTTPerrorDeskripsi
400bad_request / missing_imageParameter tidak ada atau tidak valid.
401auth_required / invalid_keyKunci API tidak ada, tidak valid, atau telah dicabut.
402insufficient_credits / free_quota_exceededKredit habis (untuk ukuran penuh) atau kuota gratis habis (untuk pratinjau).
422too_large / bad_type / fetch_failedGambar tidak dapat dibaca atau diunduh.
429rate_limitedTerlalu banyak permintaan – kurangi frekuensinya atau hubungi kami untuk batas yang lebih tinggi.
500processing_failedPemrosesan gagal di pihak kami – Anda tidak dikenai biaya.

Contoh kode

Semua contoh menggunakan endpoint yang sama. Unduh koleksi contoh lengkap: bgcut-api-examples.zip

Batasan

  • 60 permintaan per menit per kunci API (batas lebih tinggi tersedia atas permintaan).
  • Maks. 25 MB dan 30 megapiksel per gambar; gambar yang lebih besar akan diperkecil.
  • Gambar yang diproses disimpan selama 30 hari dan dapat disempurnakan di editor web.
  • Permintaan yang gagal tidak pernah dikenai biaya; biaya dikembalikan otomatis jika pembuatan hasil gagal.

Mulai integrasi

Buat akun gratis, buat kunci, dan lakukan panggilan pertama Anda dalam waktu kurang dari satu menit.

Dapatkan kunci API Harga