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:
| Sebelum | https://api.remove.bg/v1.0/removebg |
|---|---|
| Selepas | https://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.
Dapatkan kunci
- Log masuk dengan Google.
- Buka Akaun Saya dan cipta kunci di bahagian Kunci API buang latar belakang.
- Salin kunci apabila ia dipaparkan. Ia hanya dipaparkan sekali.
Mula pantas
Hantar imej sebagai muat naik fail, base64 atau URL awam. Kandungan respons ialah imej yang siap.
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()));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.
| Medan | Nilai | Catatan |
|---|---|---|
| image_file | fail | JPG, PNG atau WebP sehingga 22 MB. |
| image_file_b64 | rentetan base64 | Fail yang sama dalam base64. Awalan data: URL diterima. |
| image_url | URL http(s) | Kami yang memuat turunnya. Alamat awam dan port web standard sahaja, sehingga 3 ubah hala. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/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. |
| format | auto · png · jpg · webp · zip | auto memulangkan PNG jika hasilnya lutsinar dan JPG jika tidak. zip mengandungi color.jpg dan alpha.png, seperti di remove.bg. |
| channels | rgba · alpha | alpha hanya memulangkan topeng dalam skala kelabu. |
| bg_color | heks (81d4fa, #81d4fa77) atau nama warna | Mengisi latar yang dibuang. JPG tanpa bg_color diratakan di atas putih. |
| crop | true · false | Memangkas hasil mengikut subjek. |
| crop_margin | cth. 30px atau 10% | Ruang di sekeliling subjek yang dipangkas. Sehingga 500px atau 50%. |
| type | auto · person · product · car · animal · graphic · transportation | Diterima demi keserasian. Dipulangkan dalam X-Type; tidak mengubah potongan. |
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. Hantar Accept: application/json untuk mendapatkan 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. credits.total dan api.free_calls kedua-duanya ialah bilangan imej yang tinggal hari ini.
Ralat
Ralat menggunakan format remove.bg seperti di bawah. Permintaan yang gagal tidak menggunakan kuota.
{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}| Status | Maksud |
|---|---|
| 400 | Input salah: tiada imej, dua imej, fail tidak boleh dibaca, pilihan tidak disokong, atau image_url yang tidak dibenarkan atau gagal dimuat turun. |
| 403 | Pengepala X-Api-Key tiada, salah atau sudah dibatalkan. |
| 429 | 50 imej hari ini sudah habis. Retry-After memberi bilangan saat sehingga kuota ditetapkan semula. |
| 503 | Pemprosesan 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.
- Belum ada pelan berbayar, jadi buat masa ini kuota harian ialah hadnya.
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.
- 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