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ước | https://api.remove.bg/v1.0/removebg |
|---|---|
| Sau | https://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
- Đăng nhập bằng Google.
- Mở Tài khoản của tôi và tạo khóa trong mục Khóa API xóa nền.
- Sao chép khóa khi nó hiện ra. Khóa chỉ hiển thị một lần.
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 -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()));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ường | Giá trị | Ghi chú |
|---|---|---|
| image_file | tệp | JPG, PNG hoặc WebP, tối đa 22 MB. |
| image_file_b64 | chuỗi base64 | Cùng tệp ở dạng base64. Chấp nhận tiền tố data: URL. |
| image_url | URL 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. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/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. |
| format | auto · png · jpg · webp · zip | auto 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. |
| channels | rgba · alpha | alpha chỉ trả về mặt nạ, dạng thang xám. |
| bg_color | mã hex (81d4fa, #81d4fa77) hoặc tên màu | Tô phần nền đã xóa. JPG không có bg_color sẽ được ghép lên nền trắng. |
| crop | true · false | Cắt kết quả sát chủ thể. |
| crop_margin | ví dụ 30px hoặc 10% | Khoảng trống quanh chủ thể đã cắt. Tối đa 500px hoặc 50%. |
| type | auto · person · product · car · animal · graphic · transportation | Nhậ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:
{
"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 |
|---|---|
| 400 | Dữ 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. |
| 403 | Thiế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. |
| 503 | Tạ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