API của remove.bg sắp ngừng hoạt động. Đổi một dòng, giữ nguyên code.
Website độc lập và API tự phục vụ của remove.bg sẽ kết thúc vào . API chuyển sang Leonardo.Ai (một công ty của Canva), buộc bạn phải thay đổi tích hợp (thông báo của Leonardo.Ai). removebackground.dev chấp nhận đúng các yêu cầu đó: trỏ code tới URL của chúng tôi, dùng khóa của chúng tôi, vậy là xong.
API tự phục vụ của remove.bg kết thúc vào
Dòng duy nhất cần thay đổi
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgVẫn header X-Api-Key, với khóa removebackground.dev của bạn. Cùng tên tham số, cùng header phản hồi, cùng định dạng lỗi {"errors": [...]}.
Trước và sau
Một tích hợp điển hình bằng bốn ngôn ngữ. Khóa được lấy từ REMOVEBG_API_KEY, nên chỉ cần sửa URL được tô sáng.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Đang dùng Zapier, Make hoặc n8n?
Mở bước HTTP request đang gọi remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), đổi URL thành https://removebackground.dev/v1.0/removebg và giá trị X-Api-Key thành khóa removebackground.dev của bạn. Giữ nguyên mọi trường khác.
Tương thích tham số
Mọi thứ yêu cầu remove.bg của bạn gửi đi đều được chấp nhận. Một vài tùy chọn không có tác dụng ở đây, và được ghi rõ bên dưới.
| Tham số | Trạng thái | Ghi chú |
|---|---|---|
image_file / image_file_b64 / image_url | Hỗ trợ | Body dạng multipart, urlencoded hoặc JSON. JPG, PNG hoặc WebP tối đa 25 MB. |
size | Hỗ trợ | auto, full, 4k và 50MP cho độ phân giải gốc (tối đa 25 MP); preview, small và regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Luôn là 1 credit. |
format | Hỗ trợ | auto (PNG nếu có nền trong suốt, nếu không thì JPG), png, jpg, webp và zip (color.jpg + alpha.png). |
crop / crop_margin | Hỗ trợ | px hoặc % của chủ thể, 1–4 giá trị theo kiểu CSS ("10% 20%" = dọc, ngang); tối đa 500px hoặc 50% mỗi cạnh. |
roi | Hỗ trợ | "x1 y1 x2 y2" tính bằng px hoặc %: chỉ giữ chủ thể nằm trong vùng này. |
scale / position | Hỗ trợ | scale từ 10%–100% hoặc original; position là center, original hoặc "x% y%". |
channels | Hỗ trợ | rgba (ảnh tách nền) hoặc alpha (mặt nạ thang xám). |
bg_color | Hỗ trợ | Mã hex có hoặc không có # (81d4fa), hoặc tên màu. Mã hex 8 chữ số giữ màu và bỏ kênh alpha. |
bg_image_url / bg_image_file | Hỗ trợ | Ảnh tách nền được ghép lên ảnh nền của bạn, co giãn kiểu cover theo kích thước đầu ra. |
Accept: application/json | Hỗ trợ | Trả về { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Chấp nhận, bỏ qua | Chủ thể được nhận diện tự động; X-Type luôn là "other". |
semitransparency | Chấp nhận, bỏ qua | Viền mềm và vùng bán trong suốt được giữ nguyên theo matte của mô hình. |
shadow_type / shadow_opacity / add_shadow | Chấp nhận, bỏ qua | Không thêm bóng đổ. |
Yêu cầu chạy lâu | Khác biệt | Chúng tôi chờ tối đa 110 giây; nếu ảnh chưa xong vào lúc đó, bạn nhận mã 503 có thể thử lại (không tính phí trừ khi ảnh đã xử lý xong). |
Header phản hồi
Một lệnh gọi thành công trả về dữ liệu ảnh (image/png, image/jpeg, image/webp hoặc application/zip) cùng các header sau. Gửi Accept: application/json để nhận result_b64 thay thế.
| Header | Ý nghĩa |
|---|---|
X-Width / X-Height | Kích thước kết quả tính bằng pixel. |
X-Credits-Charged | Số credit ảnh này đã dùng: luôn là 1 (ảnh lỗi tốn 0). |
X-Type | Luôn là "other" (nhận diện chủ thể tự động). |
X-Foreground-Top / -Left / -Width / -Height | Khung bao của chủ thể trong kết quả, tính bằng pixel. |
X-Request-ID | Trả lại X-Request-ID của bạn, hoặc một id được tạo tự động. Bổ sung. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Độ sạch của mặt nạ (0–1), và tỷ lệ pixel mềm. Bổ sung: hữu ích để đánh dấu ảnh cần kiểm tra lại. |
Lỗi
| Trạng thái | Ý nghĩa |
|---|---|
400 | Tham số hoặc ảnh không hợp lệ (các mã như invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: nạp thêm ở trang bảng giá. |
403 | auth_failed: thiếu hoặc sai X-Api-Key. |
429 | rate_limit_exceeded. |
500 / 503 | Xử lý thất bại, hết thời gian chờ hoặc dịch vụ tạm thời không khả dụng. Hãy thử lại; ảnh lỗi miễn phí. |
Kiểm tra số dư bằng GET https://removebackground.dev/v1.0/account: phản hồi có cấu trúc tài khoản giống remove.bg. Chi tiết đầy đủ trong tài liệu tham khảo API.
Credit: 1 credit mỗi ảnh, và không bao giờ hết hạn
Mỗi ảnh thành công tốn 1 credit, bất kể kích thước hay tùy chọn. Ảnh lỗi miễn phí. Tài khoản mới được tặng 50 credit miễn phí để dùng thử.
- Credit không bao giờ hết hạnNạp một lần, dùng tuần sau hay năm sau đều được.
- Không gói thángGói mua một lần. Không tự động gia hạn.
- Ảnh lỗi miễn phíCredit chỉ bị trừ khi tách nền thành công.
Danh sách kiểm tra khi chuyển đổi
- Lấy khóa API removebackground.devĐăng ký (tặng 50 credit miễn phí) và tạo khóa ở trang tài khoản.
- Đổi một dòngTrỏ code của bạn tới https://removebackground.dev/v1.0/removebg và đặt khóa mới vào cùng header X-Api-Key.
- Thử một ảnhChạy một yêu cầu thực tế và so sánh đầu ra với kết quả bạn đang nhận hiện nay.
- Chuyển lưu lượngTriển khai trước lúc 09:00 1 tháng 12, 2026 CET. Nạp credit một lần; credit không bao giờ hết hạn.
Câu hỏi thường gặp khi chuyển từ remove.bg
remove.bg có ngừng hoạt động không?
Website độc lập và API tự phục vụ của remove.bg sẽ kết thúc vào lúc 09:00 1 tháng 12, 2026 CET. API chuyển sang Leonardo.Ai (một công ty của Canva), buộc bạn phải thay đổi tích hợp. Nguồn: thông báo của Leonardo.Ai tại https://www.leonardo.ai/news/removebg-api-leonardo.
Cách đơn giản nhất để thay thế API remove.bg là gì?
removebackground.dev có một endpoint tương thích remove.bg. Đổi https://api.remove.bg/v1.0/removebg thành https://removebackground.dev/v1.0/removebg, gửi khóa removebackground.dev trong cùng header X-Api-Key, và giữ nguyên phần còn lại của code: tên tham số, header phản hồi và định dạng lỗi đều khớp.
Tôi có phải viết lại tích hợp trước tháng 12/2026 không?
Không. Yêu cầu giữ nguyên các tham số (image_file, image_url, size, format, crop, bg_color…) và nhận cùng kiểu phản hồi: dữ liệu ảnh với các header X-Width, X-Height và X-Foreground-*, hoặc JSON với result_b64. Chỉ URL và khóa thay đổi.
Có dùng được với Zapier, Make hoặc n8n không?
Có. Trong bước HTTP request (Zapier Webhooks, Make HTTP, n8n HTTP Request), đổi URL thành https://removebackground.dev/v1.0/removebg và giá trị X-Api-Key thành khóa removebackground.dev của bạn. Không cần thay đổi gì khác.
Chi phí bao nhiêu?
1 credit cho mỗi ảnh thành công, bất kể kích thước hay tùy chọn. Không gói tháng: nạp một lần 17 US$, 49 US$ hoặc 99 US$, và credit không bao giờ hết hạn. Ảnh lỗi miễn phí. Tài khoản mới được tặng 50 credit miễn phí.
Những tham số nào của remove.bg được hỗ trợ?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url và bg_image_file. type, type_level, semitransparency và các tùy chọn shadow được chấp nhận và bỏ qua, nên các yêu cầu có gửi chúng vẫn hoạt động.
Tôi có thể kiểm tra số dư như trước không?
Có. GET https://removebackground.dev/v1.0/account với khóa của bạn sẽ trả về số credit theo định dạng tài khoản của remove.bg.
removebackground.dev có liên kết với remove.bg không?
Không. remove.bg là nhãn hiệu của chủ sở hữu. removebackground.dev là một dịch vụ độc lập chấp nhận cùng các yêu cầu API.
Chuyển đổi trước lúc 09:00 1 tháng 12, 2026 CET
API tự phục vụ của remove.bg kết thúc vào
Tạo khóa, đổi một dòng, thử một ảnh. Tặng kèm 50 credit miễn phí.
remove.bg là nhãn hiệu của chủ sở hữu; removebackground.dev không liên kết với họ.