Ghost Mannequin · Tính năng
Ghost Mannequin API — Photta
Tách ma-nơ-canh khỏi ảnh trang phục và giữ nguyên cấu trúc bên trong — đường may, lớp lót, nhãn mác. Hoàn thiện kiểu Hollow-man hoặc trải sàn, sẵn sàng xử lý hàng loạt, 4 credits ở 2K.
Tóm tắt trong một câu
Ghost Mannequin API của Photta nhận ảnh trang phục trên ma-nơ-canh và trả về ảnh ma-nơ-canh vô hình với phần bên trong của trang phục được tái tạo. POST tới `/api/v1/ghost-mannequin` với một `product_image_url`, một `style` (hollow_man hoặc flat_lay), và một resolution. Poll `/api/v1/ghost-mannequin/:id` mỗi 3 giây cho đến khi status chuyển sang `completed`.
curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image_url": "https://example.com/tshirt-on-model.jpg",
"style": "hollow_man",
"resolution": "2K"
}'Kỳ vọng gì
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
Code toàn quy trình
Chọn ngôn ngữ của bạn
Cùng cấu trúc REST; endpoint Ghost Mannequin cũng hỗ trợ xử lý hàng loạt cho các danh mục sản phẩm lớn.
Cách hoạt động
Một ảnh đầu vào, một ảnh ma-nơ-canh vô hình đầu ra
Tải ảnh gốc, chọn phong cách, gửi yêu cầu, poll, tải về.
- 01
Bước 1
Tạo API key
Ghost Mannequin sử dụng cùng thông tin xác thực như mọi tính năng khác của Photta — một key, một số dư credit.
- 02
Bước 2
Tải ảnh gốc lên
Bạn có thể truyền một URL công khai trong `product_image_url` hoặc tải dữ liệu lên trước qua `/api/v1/uploads`. Endpoint chấp nhận định dạng JPG, PNG và WebP.
- 03
Bước 3
POST tác vụ Ghost Mannequin
POST tới `/api/v1/ghost-mannequin` với `product_image_url`, `style` (hollow_man hoặc flat_lay), `resolution`. Truyền `webhook_url` nếu bạn muốn nhận thông báo khi tác vụ hoàn thành — polling vẫn là phương thức chính.
- 04
Bước 4
Poll cho đến khi tác vụ hoàn thành
GET tới `/api/v1/ghost-mannequin/:id` mỗi 3 giây. Ghost Mannequin nhanh hơn thử đồ — thường từ 1 đến 3 phút — vì không phải render thêm người mới.
- 05
Bước 5
Tải về và lưu trữ
Kết quả là một file PNG đã xóa ma-nơ-canh và tái tạo phần bên trong trang phục. Lý tưởng cho ảnh Ghost trên trang sản phẩm, bộ sưu tập sản phẩm cảm giác 3D và chèn vào ảnh trải sàn.
Câu hỏi từ các nhà phát triển khác
Câu hỏi nhà phát triển thắc mắc trước khi triển khai Ghost Mannequin
Chụp ảnh Ghost Mannequin là gì?+
Một cách xử lý ảnh cho trang sản phẩm nơi trang phục trông như đang lơ lửng trên một cơ thể vô hình, hiển thị cả phom dáng và cấu trúc bên trong cùng lúc. Trước đây, nó được ghép từ nhiều ảnh chụp studio; API của Photta tạo ra nó chỉ với một lệnh gọi từ một ảnh chụp trên ma-nơ-canh.
Chi phí Ghost Mannequin là bao nhiêu?+
4 credits ở 2K, 6 credits ở 4K — rẻ hơn một credit so với tính năng thử đồ ở mỗi cấp độ. Các tác vụ thất bại được hoàn lại tự động.
Sự khác biệt giữa kiểu Hollow-man và Flat-lay là gì?+
Hollow-man giữ nguyên phom dáng cơ thể 3D của ma-nơ-canh — trang phục giữ được khối lượng, vai và tay áo trông tự nhiên, và phần bên trong được tái tạo. Flat-lay biến trang phục thành dạng trải sàn 2D sạch sẽ, lý tưởng cho các bộ sưu tập capsule hoặc các sàn thương mại điện tử yêu cầu phom dáng mặt trước đồng nhất.
Tôi có thể xử lý hàng loạt nhiều ảnh không?+
Có. POST tới `/api/v1/ghost-mannequin/batch` với một mảng các ảnh nguồn. Phản hồi sẽ trả về cho bạn một ID lô (batch ID) kèm theo ID tạo ảnh của từng mục. Poll `/api/v1/ghost-mannequin/batch/:id` để xem trạng thái tổng hợp hoặc poll từng mục riêng lẻ.
Nó có bảo toàn đường may và nhãn mác bên trong không?+
Có — mô hình tái tạo phần bên trong của trang phục (mặt trong cổ áo, mặt trong tay áo, lớp lót thắt lưng) thay vì tạo ra một bề mặt chung chung. Nhãn mác và nhãn in có thể nhìn thấy trên ảnh gốc sẽ được giữ lại khi có thể.
Làm thế nào để poll kết quả?+
GET tới `/api/v1/ghost-mannequin/:id` mỗi 3 giây. Các tác vụ hàng loạt sẽ poll một endpoint cha để trả về trạng thái tổng hợp kèm chi tiết từng mục.
Ghost Mannequin · Tính năng
Tạo tài khoản và lấy API key
Ghost Mannequin API của Photta nhận ảnh trang phục trên ma-nơ-canh và trả về ảnh ma-nơ-canh vô hình với phần bên trong của trang phục được tái tạo. POST tới `/api/v1/ghost-mannequin` với một `product_image_url`, một `style` (hollow_man hoặc flat_lay), và một resolution. Poll `/api/v1/ghost-mannequin/:id` mỗi 3 giây cho đến khi status chuyển sang `completed`.