API hapus latar belakang
Permintaan yang sama dengan API remove.bg, respons yang sama. Ganti URL dasar dan kunci; sisa kode Anda tidak perlu diubah.
Pindah dari remove.bg
remove.bg telah mengumumkan bahwa layanan mandirinya ditutup pada 1 Desember 2026 dan permintaan API swalayan berhenti di hari yang sama, dengan API-nya pindah ke Leonardo.Ai. Jika kode Anda memanggil api.remove.bg, arahkan ke sini:
| Sebelum | https://api.remove.bg/v1.0/removebg |
|---|---|
| Sesudah | https://imagic-ai.com/api/v1.0/removebg |
Header tetap X-Api-Key, nama field tidak berubah, dan error memakai format remove.bg, jadi pustaka klien yang URL dasarnya bisa diatur langsung berfungsi.
Dapatkan kunci
- Masuk dengan Google.
- Buka Akun Saya dan buat kunci di bagian Kunci API hapus latar belakang.
- Salin kunci saat ditampilkan. Kunci hanya muncul sekali.
Mulai cepat
Kirim gambar sebagai unggahan file, base64, atau URL publik. Isi respons adalah gambar yang sudah jadi.
curl -H "X-Api-Key: $IMAGIC_API_KEY" \
-F "image_file=@photo.jpg" \
-F "size=auto" \
-o no-bg.png \
https://imagic-ai.com/api/v1.0/removebgimport os, requests
response = requests.post(
"https://imagic-ai.com/api/v1.0/removebg",
files={"image_file": open("photo.jpg", "rb")},
data={"size": "auto"},
headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
out.write(response.content)import { readFile, writeFile } from "node:fs/promises";
const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");
const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
method: "POST",
headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));Field permintaan
POST /api/v1.0/removebg menerima multipart/form-data, application/x-www-form-urlencoded, atau JSON. Kirim tepat satu dari tiga field gambar.
| Field | Nilai | Catatan |
|---|---|---|
| image_file | file | JPG, PNG, atau WebP hingga 22 MB. |
| image_file_b64 | string base64 | File yang sama dalam base64. Awalan data: URL diterima. |
| image_url | URL http(s) | Kami yang mengunduhnya. Hanya alamat publik dan port web standar, maksimal 3 pengalihan. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/small/regular: hingga 0,25 MP. medium: 1,5 MP. hd: 4 MP. full/4k/auto/50MP: hingga 25 MP (PNG hingga 10 MP). Setiap ukuran dihitung satu gambar. |
| format | auto · png · jpg · webp · zip | auto mengembalikan PNG jika hasilnya transparan dan JPG jika tidak. zip berisi color.jpg dan alpha.png, seperti di remove.bg. |
| channels | rgba · alpha | alpha hanya mengembalikan mask dalam skala abu-abu. |
| bg_color | hex (81d4fa, #81d4fa77) atau nama warna | Mengisi latar yang dihapus. JPG tanpa bg_color diratakan di atas putih. |
| crop | true · false | Memangkas hasil sampai batas objek. |
| crop_margin | mis. 30px atau 10% | Ruang di sekitar objek yang dipangkas. Hingga 500px atau 50%. |
| type | auto · person · product · car · animal · graphic · transportation | Diterima demi kompatibilitas. Dikembalikan di X-Type; tidak mengubah potongan. |
scale, position, roi, bg_image_url, bg_image_file, dan opsi bayangan tidak didukung. Permintaan yang memakainya mendapat 400, bukan gambar berbeda tanpa pemberitahuan.
Respons
Secara default isi respons adalah gambarnya sendiri, dengan header: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (selalu 1), serta X-RateLimit-Limit / -Remaining / -Reset untuk kuota harian. Kirim Accept: application/json untuk mendapatkan JSON:
{
"data": {
"result_b64": "iVBORw0KGgo…",
"foreground_top": 115,
"foreground_left": 477,
"foreground_width": 637,
"foreground_height": 824
}
}Sisa kuota
GET /api/v1.0/account mengembalikan struktur akun remove.bg. credits.total dan api.free_calls sama-sama berisi jumlah gambar yang tersisa hari ini.
Error
Error memakai format remove.bg seperti di bawah. Permintaan yang gagal tidak memotong kuota.
{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}| Status | Arti |
|---|---|
| 400 | Input salah: tanpa gambar, dua gambar, file tidak terbaca, opsi tidak didukung, atau image_url yang tidak boleh atau gagal kami unduh. |
| 403 | Header X-Api-Key tidak ada, salah, atau sudah dicabut. |
| 429 | 50 gambar hari ini sudah habis. Retry-After berisi detik hingga kuota direset. |
| 503 | Pemrosesan sedang tidak tersedia. Coba lagi sebentar lagi. |
Batasan
- 50 gambar per hari per akun, dipakai bersama oleh semua kunci. Hingga 3 kunci aktif per akun agar bisa dirotasi.
- Unggahan hingga 22 MB. Keluaran hingga 25 MP, atau 10 MP untuk PNG.
- Permintaan diantrekan dan diproses beberapa sekaligus. Perkirakan beberapa detik per gambar, lebih lama untuk foto besar.
- Belum ada paket berbayar, jadi untuk sekarang kuota harian adalah batas atasnya.
Seperti apa hasil potongannya
Potongan dibuat model isnet-general-use, sama dengan Penghapus Latar Belakang. Model ini andal untuk produk, orang, dan hewan di latar biasa. Kelemahannya ada pada rambut halus, kaca, dan objek yang warnanya mirip latar; di situ model remove.bg sendiri bisa lebih baik. Uji beberapa gambar Anda sebelum memindahkan alur produksi.
Pertanyaan
- Apakah ini pengganti resmi remove.bg?
- Bukan. Imagic AI tidak berafiliasi dengan remove.bg, Canva, atau Leonardo.Ai. API ini menerima format permintaan remove.bg agar kode yang ada tetap berjalan.
- Apakah API-nya gratis?
- Ya. Setiap akun mendapat 50 gambar per hari tanpa biaya. Setiap ukuran, termasuk preview, dihitung satu gambar.
- Apakah pustaka klien resmi remove.bg bisa dipakai?
- Pustaka yang URL dasarnya bisa diatur akan berfungsi dengan mengubahnya ke https://imagic-ai.com/api. Pustaka yang menanam api.remove.bg di kodenya perlu satu baris itu diubah atau dibungkus sedikit.
- Apakah gambar saya disimpan?
- Gambar yang dikirim ke API diproses lalu dikembalikan di respons. Gambar tidak masuk galeri mana pun dan tidak dipakai untuk pelatihan.
Hanya perlu beberapa gambar, tanpa kode?
Pakai Penghapus Latar Belakang