Pembangun

API buang latar belakang

Permintaan yang sama seperti API remove.bg, respons yang sama. Tukar URL asas dan kunci; selebihnya kod anda kekal.

Beralih daripada remove.bg

remove.bg telah mengumumkan bahawa perkhidmatan bersendirinya ditutup pada 1 Disember 2026 dan permintaan API layan diri berhenti pada hari yang sama, dengan API-nya berpindah ke Leonardo.Ai. Jika kod anda memanggil api.remove.bg, halakan ke sini:

Sebelumhttps://api.remove.bg/v1.0/removebg
Selepashttps://imagic-ai.com/api/v1.0/removebg

Pengepala kekal X-Api-Key, nama medan tidak berubah dan ralat mengikut format remove.bg, jadi pustaka klien yang membenarkan URL asas ditetapkan berfungsi seperti biasa.

Apa yang berubah dengan penutupan 1 Disember, dan apa yang perlu dibuat dahulu

Dapatkan kunci

  1. Log masuk dengan Google.
  2. Buka Akaun Saya dan cipta kunci di bahagian Kunci API buang latar belakang.
  3. Salin kunci apabila ia dipaparkan. Ia hanya dipaparkan sekali.
Cipta kunci

Mula pantas

Hantar imej sebagai muat naik fail, base64 atau URL awam. Kandungan respons ialah imej yang siap.

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()));

Medan permintaan

POST /api/v1.0/removebg menerima multipart/form-data, application/x-www-form-urlencoded atau JSON. Hantar tepat satu daripada tiga medan imej.

MedanNilaiCatatan
image_filefailJPG, PNG atau WebP sehingga 22 MB.
image_file_b64rentetan base64Fail yang sama dalam base64. Awalan data: URL diterima.
image_urlURL http(s)Kami yang memuat turunnya. Alamat awam dan port web standard sahaja, sehingga 3 ubah hala.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: sehingga 0.25 MP. medium: 1.5 MP. hd: 4 MP. full/4k/auto/50MP: sehingga 25 MP (PNG sehingga 10 MP). Setiap saiz dikira satu imej.
formatauto · png · jpg · webp · zipauto memulangkan PNG jika hasilnya lutsinar dan JPG jika tidak. zip mengandungi color.jpg dan alpha.png, seperti di remove.bg.
channelsrgba · alphaalpha hanya memulangkan topeng dalam skala kelabu.
bg_colorheks (81d4fa, #81d4fa77) atau nama warnaMengisi latar yang dibuang. JPG tanpa bg_color diratakan di atas putih.
croptrue · falseMemangkas hasil mengikut subjek.
crop_margincth. 30px atau 10%Ruang di sekeliling subjek yang dipangkas. Sehingga 500px atau 50%.
typeauto · person · product · car · animal · graphic · transportationDiterima demi keserasian. Dipulangkan dalam X-Type; tidak mengubah potongan.
modelfast · precisePilihan tambahan kami (remove.bg tidak menyediakannya). fast, lalai: model standard kami. precise: tepi rambut, bahagian nipis dan kaca lebih halus, sedikit lebih perlahan. Kedua-duanya dikira satu imej; pengepala X-Imagic-Model menunjukkan model yang digunakan.

scale, position, roi, bg_image_url, bg_image_file dan pilihan bayang tidak disokong. Permintaan yang menggunakannya mendapat 400, bukannya imej berbeza tanpa makluman.

Respons

Secara lalai kandungan respons ialah imej itu sendiri, dengan pengepala: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (sentiasa 1) serta X-RateLimit-Limit / -Remaining / -Reset untuk kuota harian. Imej yang dibayar dengan kredit juga membawa X-Imagic-Paid: 1 dan X-Imagic-Credit-Balance. Hantar 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
  }
}

Baki kuota

GET /api/v1.0/account memulangkan struktur akaun remove.bg. api.free_calls ialah bilangan imej percuma yang tinggal hari ini, credits.payg ialah baki kredit akaun, dan credits.total ialah jumlah kedua-duanya.

Ralat

Ralat menggunakan format remove.bg seperti di bawah. Permintaan yang gagal tidak menggunakan kuota.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
StatusMaksud
400Input salah: tiada imej, dua imej, fail tidak boleh dibaca, pilihan tidak disokong, atau image_url yang tidak dibenarkan atau gagal dimuat turun.
403Pengepala X-Api-Key tiada, salah atau sudah dibatalkan.
422Model yang diminta tidak tersedia buat masa ini (kod model_unavailable). Cuba semula dengan model=fast; imej tidak dikira.
42950 imej percuma hari ini sudah habis dan akaun tiada kredit lagi, atau akaun telah mencapai 1,000 imej berbayar hari ini. Retry-After memberi bilangan saat sehingga imej percuma ditetapkan semula.
503Pemprosesan tidak tersedia buat sementara. Cuba lagi sebentar nanti.

Had

  • 50 imej sehari setiap akaun, dikongsi oleh semua kunci. Sehingga 3 kunci aktif setiap akaun supaya boleh digilirkan.
  • Muat naik sehingga 22 MB. Output sehingga 25 MP, atau 10 MP untuk PNG.
  • Permintaan dibariskan dan diproses beberapa pada satu masa. Jangkakan beberapa saat setiap imej, lebih lama untuk foto besar.
  • Selepas 50 imej percuma, setiap imej menggunakan satu kredit daripada baki akaun, sehingga 1,000 imej berbayar sehari. Kredit dibeli di halaman akaun (100 untuk US$5 atau 500 untuk US$19) dan tidak luput.

Apa yang dijangka daripada potongan

Potongan dihasilkan oleh model isnet-general-use, sama seperti Penyingkir Latar Belakang. Ia boleh diharap untuk produk, orang dan haiwan di latar biasa. Kelemahannya pada rambut halus, kaca dan subjek yang sewarna dengan latar; di situ model remove.bg sendiri mungkin lebih baik. Uji beberapa imej anda sebelum memindahkan aliran pengeluaran.

Soalan

Adakah ini pengganti rasmi remove.bg?
Bukan. Imagic AI tidak bergabung dengan remove.bg, Canva atau Leonardo.Ai. API ini menerima format permintaan remove.bg supaya kod sedia ada terus berfungsi.
Adakah API ini percuma?
Ya. Setiap akaun mendapat 50 imej sehari tanpa bayaran. Setiap saiz, termasuk preview, dikira satu imej. Selepas itu, setiap imej menggunakan satu kredit (100 kredit berharga US$5).
Adakah pustaka klien rasmi remove.bg berfungsi?
Pustaka yang membenarkan URL asas ditetapkan berfungsi dengan menukarnya kepada https://imagic-ai.com/api. Pustaka yang menetapkan api.remove.bg dalam kod perlu baris itu diubah atau pembalut kecil.
Adakah imej saya disimpan?
Imej yang dihantar ke API diproses dan dipulangkan dalam respons. Ia tidak dimasukkan ke mana-mana galeri dan tidak digunakan untuk latihan.

Perlu beberapa imej sahaja, tanpa kod?

Guna Penyingkir Latar Belakang