Nhà phát triển

API xóa nền

Cùng yêu cầu như API của remove.bg, cùng phản hồi. Đổi URL gốc và khóa; phần còn lại của mã giữ nguyên.

Chuyển từ remove.bg

remove.bg đã thông báo dịch vụ độc lập sẽ đóng vào ngày 1/12/2026 và các yêu cầu API tự phục vụ dừng cùng ngày, API chuyển sang Leonardo.Ai. Nếu mã của bạn gọi api.remove.bg, hãy trỏ sang đây:

Trướchttps://api.remove.bg/v1.0/removebg
Sauhttps://imagic-ai.com/api/v1.0/removebg

Header vẫn là X-Api-Key, các trường giữ nguyên tên và lỗi giữ định dạng của remove.bg, nên thư viện client cho phép đặt URL gốc sẽ chạy như cũ.

Lấy khóa

  1. Đăng nhập bằng Google.
  2. Mở Tài khoản của tôi và tạo khóa trong mục Khóa API xóa nền.
  3. Sao chép khóa khi nó hiện ra. Khóa chỉ hiển thị một lần.
Tạo khóa

Bắt đầu nhanh

Gửi ảnh dưới dạng tệp tải lên, base64 hoặc URL công khai. Nội dung phản hồi chính là ảnh đã xử lý.

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

Các trường yêu cầu

POST /api/v1.0/removebg nhận multipart/form-data, application/x-www-form-urlencoded hoặc JSON. Chỉ gửi một trong ba trường ảnh.

TrườngGiá trịGhi chú
image_filetệpJPG, PNG hoặc WebP, tối đa 22 MB.
image_file_b64chuỗi base64Cùng tệp ở dạng base64. Chấp nhận tiền tố data: URL.
image_urlURL http(s)Chúng tôi tải về. Chỉ địa chỉ công khai và cổng web tiêu chuẩn, tối đa 3 lần chuyển hướng.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: tối đa 0,25 MP. medium: 1,5 MP. hd: 4 MP. full/4k/auto/50MP: tối đa 25 MP (PNG tối đa 10 MP). Mọi kích thước đều tính là một ảnh.
formatauto · png · jpg · webp · zipauto trả về PNG khi kết quả trong suốt, JPG khi không. zip gồm color.jpg và alpha.png như trên remove.bg.
channelsrgba · alphaalpha chỉ trả về mặt nạ, dạng thang xám.
bg_colormã hex (81d4fa, #81d4fa77) hoặc tên màuTô phần nền đã xóa. JPG không có bg_color sẽ được ghép lên nền trắng.
croptrue · falseCắt kết quả sát chủ thể.
crop_marginví dụ 30px hoặc 10%Khoảng trống quanh chủ thể đã cắt. Tối đa 500px hoặc 50%.
typeauto · person · product · car · animal · graphic · transportationNhận để tương thích. Được trả lại trong X-Type, không làm thay đổi kết quả tách nền.

Không hỗ trợ scale, position, roi, bg_image_url, bg_image_file và các tùy chọn đổ bóng. Yêu cầu dùng chúng sẽ nhận lỗi 400 thay vì lặng lẽ trả về một ảnh khác.

Phản hồi

Mặc định nội dung phản hồi là chính bức ảnh, kèm các header: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (luôn là 1) và X-RateLimit-Limit / -Remaining / -Reset cho hạn mức ngày. Gửi Accept: application/json để nhận JSON:

Accept: application/json
{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

Hạn mức còn lại

GET /api/v1.0/account trả về cấu trúc tài khoản giống remove.bg. credits.total và api.free_calls đều là số ảnh còn lại trong hôm nay.

Lỗi

Lỗi dùng định dạng của remove.bg như bên dưới. Yêu cầu thất bại không bị trừ ảnh.

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}
Mã trạng tháiÝ nghĩa
400Dữ liệu sai: không có ảnh, có hai ảnh, tệp không đọc được, tùy chọn không hỗ trợ, hoặc image_url không được phép hay không tải được.
403Thiếu header X-Api-Key, khóa sai hoặc đã bị thu hồi.
429Đã dùng hết 50 ảnh hôm nay. Retry-After cho biết số giây đến khi hạn mức đặt lại.
503Tạm thời không xử lý được. Vui lòng thử lại sau ít phút.

Giới hạn

  • 50 ảnh mỗi ngày cho mỗi tài khoản, dùng chung cho mọi khóa. Tối đa 3 khóa đang hoạt động để bạn có thể xoay vòng.
  • Tải lên tối đa 22 MB. Kết quả tối đa 25 MP, hoặc 10 MP với PNG.
  • Yêu cầu được xếp hàng và xử lý vài yêu cầu một lúc. Mỗi ảnh mất vài giây, ảnh lớn lâu hơn.
  • Hiện chưa có gói trả phí, nên hạn mức ngày là mức tối đa.

Chất lượng tách nền ra sao

Tách nền dùng mô hình isnet-general-use, giống Công cụ xóa nền. Nó ổn định với sản phẩm, người và động vật trên nền thông thường. Điểm yếu là tóc mảnh, thủy tinh và chủ thể cùng màu với nền; ở đó mô hình của remove.bg có thể làm tốt hơn. Hãy thử vài ảnh của chính bạn trước khi chuyển quy trình sản xuất.

Câu hỏi

Đây có phải là bản thay thế chính thức của remove.bg không?
Không. Imagic AI không liên kết với remove.bg, Canva hay Leonardo.Ai. API nhận định dạng yêu cầu của remove.bg để mã hiện có vẫn chạy.
API có miễn phí không?
Có. Mỗi tài khoản có 50 ảnh mỗi ngày miễn phí. Mọi kích thước, kể cả preview, đều tính là một ảnh.
Thư viện client chính thức của remove.bg có dùng được không?
Thư viện cho phép đặt URL gốc sẽ chạy khi đổi sang https://imagic-ai.com/api. Thư viện ghi cứng api.remove.bg cần sửa dòng đó trong mã nguồn hoặc thêm một lớp bọc nhỏ.
Các bạn có lưu ảnh của tôi không?
Ảnh gửi tới API được xử lý và trả về trong phản hồi. Ảnh không được đưa vào thư viện nào và không dùng để huấn luyện.

Chỉ cần vài ảnh, không viết mã?

Dùng Công cụ xóa nền