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ũ.

Việc đóng cửa ngày 1/12 thay đổi gì và nên làm gì trướ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.
modelfast · preciseTùy chọn riêng của chúng tôi (remove.bg không có). fast, mặc định: mô hình tiêu chuẩn. precise: viền tóc, chi tiết mảnh và kính sắc nét hơn, chậm hơn một chút. Cả hai đều tính là một ảnh; header X-Imagic-Model cho biết mô hình đã dùng.

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. Ảnh được trả bằng tín dụng còn có thêm X-Imagic-Paid: 1 và X-Imagic-Credit-Balance. 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. api.free_calls là số ảnh miễn phí còn lại trong hôm nay, credits.payg là số dư tín dụng của tài khoản, còn credits.total là tổng của hai số đó.

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 free 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.
422Mô hình yêu cầu hiện không khả dụng (mã model_unavailable). Hãy thử lại với model=fast; ảnh không bị tính.
429Đã dùng hết 50 ảnh miễn phí hôm nay và tài khoản không còn tín dụng, hoặc đã đạt 1.000 ảnh trả phí trong hôm nay. Retry-After cho biết số giây đến khi lượt ảnh miễn phí đặ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.
  • Sau 50 ảnh miễn phí, mỗi ảnh dùng một tín dụng từ số dư của tài khoản, tối đa 1.000 ảnh trả phí mỗi ngày. Tín dụng được mua ở trang tài khoản (100 tín dụng giá 5 USD hoặc 500 tín dụng giá 19 USD) và không hết hạn.

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. Vượt quá mức đó, mỗi ảnh dùng một tín dụng (100 tín dụng giá 5 USD).
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