API Xóa Ảnh Nền
Giá cả
25 credits cho mỗi yêu cầu
Chi phí cố định bất kể kích thước ảnh hay độ phức tạp.
Tổng quan
API Xóa Ảnh Nền sử dụng AI (rembg với mô hình U²-Net) để tự động xóa nền khỏi ảnh, tạo ra file PNG có độ trong suốt. Hoàn hảo cho việc tạo ảnh sản phẩm, chân dung và đồ họa không có nền.
Domain: api.revidapi.com
Endpoint
POST https://api.revidapi.com/paid/image/remove/background
Xác thực: Bắt buộc - Header x-api-key hoặc master key
Yêu cầu
Headers
x-api-key: Bắt buộc. API key của bạn để xác thực.Content-Type: Bắt buộc. Phải làmultipart/form-data.
Tham số Form
Tham số Bắt buộc
| Parameter | Type | Required | Default | Mô tả |
|---|---|---|---|---|
file |
file (upload) | ✅ Yes | - | File ảnh cần xóa nền (PNG, JPG, JPEG, WEBP, BMP) |
Tham số Tùy chọn
| Parameter | Type | Required | Default | Mô tả |
|---|---|---|---|---|
model |
string | ❌ No | u2net |
Mô hình AI để xóa nền |
Các Mô hình Hỗ trợ
| Model | Tốt nhất cho | Tốc độ | Chất lượng |
|---|---|---|---|
u2net ⭐ |
Sử dụng chung (mặc định) | Nhanh | Cao |
u2net_human_seg |
Chân dung người | Nhanh | Cao |
u2netp |
Xử lý nhanh | Rất nhanh | Trung bình |
u2net_cloth_seg |
Quần áo | Nhanh | Cao |
silueta |
Chân dung | Nhanh | Cao |
isnet-general-use |
Chất lượng cao nhất | Chậm hơn | Rất cao |
Định dạng Hỗ trợ
- Input: PNG, JPG, JPEG, WEBP, BMP
- Output: PNG (với độ trong suốt)
Phản hồi
Phản hồi Ngay lập tức (Task đã tạo)
POST endpoint trả về ngay với task_id:
{
"success": true,
"task_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
"status": "pending",
"message": "Background removal started",
"endpoints": {
"check_status": "/api/get/{task_id}",
"download_image": "/output/{filename} (after completion)"
}
}
Trạng thái Task (GET)
Sử dụng task_id để kiểm tra trạng thái:
GET https://edit.revidapi.com/api/get/{task_id}
⏳ Đang xử lý
{
"status": "processing",
"message": "Removing background from image...",
"progress": 50,
"created_at": "2025-01-24T10:30:00.000000",
"completed_at": null,
"result": null
}
✅ Hoàn thành
{
"status": "completed",
"message": "Background removal completed successfully",
"progress": 100,
"created_at": "2025-01-24T10:30:00.000000",
"completed_at": "2025-01-24T10:30:05.123456",
"result": {
"image_url": "https://edit.revidapi.com/output/a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6_output.png",
"image_filename": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6_output.png",
"input_size": 524288,
"output_size": 314572,
"input_size_kb": 512.0,
"output_size_kb": 307.2,
"elapsed_seconds": 2.45,
"model": "u2net"
}
}
❌ Thất bại
{
"status": "failed",
"message": "Background removal failed: Invalid image format",
"progress": 0,
"created_at": "2025-01-24T10:30:00.000000",
"completed_at": "2025-01-24T10:30:01.123456",
"result": {
"error": "Unsupported image format: gif. Supported: png, jpg, jpeg, webp, bmp"
}
}
Các Trường Kết quả
| Field | Type | Mô tả |
|---|---|---|
image_url |
string | URL để tải ảnh đã xử lý |
image_filename |
string | Tên file ảnh output |
input_size |
integer | Kích thước file input (bytes) |
output_size |
integer | Kích thước file output (bytes) |
input_size_kb |
number | Kích thước file input (KB) |
output_size_kb |
number | Kích thước file output (KB) |
elapsed_seconds |
number | Thời gian xử lý (giây) |
model |
string | Mô hình đã sử dụng |
Lưu ý: URL tải xuống là tạm thời và có thể hết hạn sau một khoảng thời gian.
Ví dụ Yêu cầu
Ví dụ 1: Sử dụng cURL
curl -X POST \
https://api.revidapi.com/paid/image/remove/background \
-H "x-api-key: YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "model=u2net"
Thời gian Xử lý
| Kích thước Ảnh | Thời gian Xử lý |
|---|---|
| < 1 MB | ~1-3 giây |
| 1-5 MB | ~3-8 giây |
| 5-10 MB | ~8-15 giây |
| > 10 MB | ~15-30 giây |
Thời gian có thể thay đổi dựa trên mô hình được chọn và tải server.
Trường hợp Sử dụng
1. Ảnh Sản phẩm E-commerce
Xóa nền khỏi ảnh sản phẩm để có danh sách sản phẩm sạch, chuyên nghiệp.
2. Ảnh Chân dung
Xóa nền khỏi ảnh chân dung để có ảnh đại diện hoặc ảnh profile chuyên nghiệp.
3. Nội dung Mạng xã hội
Tạo đồ họa bắt mắt với nền trong suốt.
4. Trích xuất Logo
Trích xuất logo từ ảnh có nền phức tạp.
5. Công việc Thiết kế
Chuẩn bị ảnh cho các dự án thiết kế yêu cầu độ trong suốt.
Best Practices
- Chọn Mô hình:
- Sử dụng
u2netcho sử dụng chung (mặc định) - Sử dụng
u2net_human_segcho chân dung -
Sử dụng
isnet-general-usecho chất lượng cao nhất (chậm hơn) -
Định dạng File:
- Upload ở định dạng PNG hoặc JPG
-
Output luôn là PNG với độ trong suốt
-
Chất lượng Ảnh:
- Ảnh độ phân giải cao cho kết quả tốt hơn
-
Tránh ảnh bị nén nhiều
-
Kiểm tra Trạng thái:
- Kiểm tra trạng thái mỗi 1-2 giây
-
Xử lý timeout (30-60 giây)
-
Xử lý Lỗi:
- Xử lý định dạng không hỗ trợ một cách nhẹ nhàng
- Kiểm tra giới hạn kích thước file trước khi upload
Hạn chế
- Kích thước file tối đa: Thường 10-20 MB (kiểm tra giới hạn server)
- Định dạng hỗ trợ: Chỉ PNG, JPG, JPEG, WEBP, BMP
- Timeout xử lý: 60 giây mỗi yêu cầu
- URL tải xuống: Có thể hết hạn sau một khoảng thời gian (tải xuống ngay)
Khắc phục Sự cố
Lỗi: Định dạng không hỗ trợ
Nguyên nhân: Định dạng ảnh không được hỗ trợ
Giải pháp: Chuyển đổi ảnh sang PNG, JPG, JPEG, WEBP hoặc BMP trước khi upload
Lỗi: File quá lớn
Nguyên nhân: Ảnh vượt quá giới hạn kích thước
Giải pháp: Nén hoặc giảm kích thước ảnh trước khi upload
Lỗi: rembg không khả dụng
Nguyên nhân: Dịch vụ xóa nền tạm thời không khả dụng
Giải pháp: Thử lại sau hoặc liên hệ hỗ trợ
Kết quả chất lượng kém
Nguyên nhân: Chất lượng ảnh, ánh sáng hoặc chọn mô hình
Giải pháp:
- Sử dụng ảnh input chất lượng cao hơn
- Thử các mô hình khác (ví dụ: isnet-general-use để có chất lượng tốt hơn)
- Đảm bảo độ tương phản tốt giữa chủ thể và nền