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ũ.
Việc đóng cửa ngày 1/12 thay đổi gì và nên làm gì trướcLấ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. |
| model | fast · precise | Tù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:
{
"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 |
|---|---|
| 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. |
| 422 | Mô 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. |
| 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.
- 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