Developer

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:

Sebelumhttps://api.remove.bg/v1.0/removebg
Sesudahhttps://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.

Apa yang berubah saat penutupan 1 Desember, dan apa yang harus dilakukan dulu

Dapatkan kunci

  1. Masuk dengan Google.
  2. Buka Akun Saya dan buat kunci di bagian Kunci API hapus latar belakang.
  3. Salin kunci saat ditampilkan. Kunci hanya muncul sekali.
Buat kunci

Mulai cepat

Kirim gambar sebagai unggahan file, base64, atau URL publik. Isi respons adalah gambar yang sudah jadi.

curl
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/removebg
Python
import 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)
Node.js
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.

FieldNilaiCatatan
image_filefileJPG, PNG, atau WebP hingga 22 MB.
image_file_b64string base64File yang sama dalam base64. Awalan data: URL diterima.
image_urlURL http(s)Kami yang mengunduhnya. Hanya alamat publik dan port web standar, maksimal 3 pengalihan.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/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.
formatauto · png · jpg · webp · zipauto mengembalikan PNG jika hasilnya transparan dan JPG jika tidak. zip berisi color.jpg dan alpha.png, seperti di remove.bg.
channelsrgba · alphaalpha hanya mengembalikan mask dalam skala abu-abu.
bg_colorhex (81d4fa, #81d4fa77) atau nama warnaMengisi latar yang dihapus. JPG tanpa bg_color diratakan di atas putih.
croptrue · falseMemangkas hasil sampai batas objek.
crop_marginmis. 30px atau 10%Ruang di sekitar objek yang dipangkas. Hingga 500px atau 50%.
typeauto · person · product · car · animal · graphic · transportationDiterima demi kompatibilitas. Dikembalikan di X-Type; tidak mengubah potongan.
modelfast · preciseOpsi tambahan kami (remove.bg tidak punya). fast, bawaan: model standar kami. precise: tepi rambut, bagian tipis, dan kaca lebih halus, sedikit lebih lambat. Keduanya dihitung satu gambar; header X-Imagic-Model menunjukkan model yang dipakai.

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. Gambar yang dibayar dengan kredit juga membawa X-Imagic-Paid: 1 dan X-Imagic-Credit-Balance. Kirim Accept: application/json untuk mendapatkan JSON:

Accept: application/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. api.free_calls berisi jumlah gambar gratis yang tersisa hari ini, credits.payg berisi saldo kredit akun, dan credits.total adalah jumlah keduanya.

Error

Error memakai format remove.bg seperti di bawah. Permintaan yang gagal tidak memotong kuota.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
StatusArti
400Input salah: tanpa gambar, dua gambar, file tidak terbaca, opsi tidak didukung, atau image_url yang tidak boleh atau gagal kami unduh.
403Header X-Api-Key tidak ada, salah, atau sudah dicabut.
422Model yang diminta sedang tidak tersedia (kode model_unavailable). Coba lagi dengan model=fast; gambar tidak dihitung.
42950 gambar gratis hari ini sudah habis dan akun tidak punya kredit lagi, atau akun sudah mencapai 1.000 gambar berbayar hari ini. Retry-After berisi detik hingga gambar gratis direset.
503Pemrosesan 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.
  • Setelah 50 gambar gratis, setiap gambar memakai satu kredit dari saldo akun, hingga 1.000 gambar berbayar per hari. Kredit dibeli di halaman akun (100 seharga US$5 atau 500 seharga US$19) dan tidak kedaluwarsa.

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. Selebihnya, setiap gambar memakai satu kredit (100 kredit seharga US$5).
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