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.

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.

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:

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. 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"}]}
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.
42950 imej hari ini sudah habis. Retry-After memberi bilangan saat sehingga kuota 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.
  • 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