Hướng dẫn · Ghost mannequin

Ghost mannequin API là gì? ảnh chụp ma-nơ-canh vô hình

Tóm tắt trong một câu

Ghost mannequin API nhận ảnh chụp trang phục trên ma-nơ-canh và trả về chính trang phục đó với phần ma-nơ-canh đã được loại bỏ cùng phần bên trong được tái tạo, giúp sản phẩm trông như đang tự giữ phom dáng.

Lấy API keyĐọc tài liệu
  • Thời gian điển hình: 1.5–4 min
  • Credits: 4 credits ở 2K · 5 credits ở 4K
  • Xử lý: async, polling

Mọi số liệu trên trang này đều lấy từ tài liệu Photta API · đã kiểm tra

Tóm tắt nhanh

Chụp ảnh ghost mannequin — hay còn gọi là ma-nơ-canh vô hình — hiển thị trang phục giữ nguyên phom dáng mà không có cơ thể bên trong. Về mặt truyền thống, ảnh được ghép lại ở khâu hậu kỳ từ nhiều khung hình studio: trang phục trên ma-nơ-canh, sau đó xóa ma-nơ-canh, rồi ghép phần bên trong của cổ áo và cổ tay áo vào.

Một API ghost mannequin xử lý việc đó chỉ trong một lệnh gọi. Bạn gửi ảnh chụp trên ma-nơ-canh, dịch vụ sẽ xóa phần phom và tái tạo những gì cần hiển thị bên trong trang phục — mặt trong cổ áo, lớp lót cổ tay, cạp quần — rồi trả về hình ảnh hoàn thiện. Tương tự như try-on, lệnh gọi này là bất đồng bộ: submit, poll, download.

Đây là quy chuẩn xử lý hình ảnh cho trang chi tiết sản phẩm (PDP) ngành may mặc, do đó đối tượng tích hợp là các đội ngũ quản lý catalogue và sàn thương mại điện tử cần giao diện đồng nhất trên hàng nghìn mặt hàng mà không phải đặt lịch studio cho từng món đồ.

Endpoint thực hiện việc này

Được trích xuất từ tài liệu API của Photta, không phải viết thủ công.

Tổng quan nhanh

Endpoint
POST /api/v1/ghost-mannequin
Xác thực
Bearer API key
Xử lý
Bất đồng bộ — polling status endpoint
Thời gian điển hình
1.5–4 min
Credits
4 credits ở 2K · 5 credits ở 4K
Tỷ lệ khung hình
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Giới hạn đầu vào
Tối đa 10 MB mỗi ảnh; JPEG, PNG, WebP
Idempotent
Không

Những yếu tố cần cân nhắc ở một ghost mannequin API

  • Dữ liệu bạn gửi lên

    Ảnh chụp trang phục trên ma-nơ-canh, kèm thêm ảnh mặt sau tùy chọn. Photta hỗ trợ định dạng JPEG, PNG và WebP với dung lượng tối đa 10 MB mỗi ảnh.

  • Định dạng kết quả đầu ra

    Endpoint của Photta nhận tham số style: 3d giữ lại độ phồng không gian ba chiều của trang phục, flat_lay dàn phẳng thành bố cục trải sàn chính diện gọn gàng.

  • Chi phí sử dụng

    4 credits ở độ phân giải 2K và 5 credits ở 4K trên Photta — thấp hơn 1 credit so với try-on ở mỗi phân hạng, tự động hoàn tiền khi tác vụ thất bại.

  • Khả năng xử lý hàng loạt

    Khối lượng công việc catalogue được đưa vào theo lô, không phải từng tấm đơn lẻ. Photta cung cấp một batch endpoint nhận một mảng, giữ trước số credits cần thiết và trả về trạng thái của từng mục.

Request đầu tiên

Cùng một lệnh gọi bằng cURL, Node.js và Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Câu hỏi thường gặp về ghost mannequin API

Ảnh ghost mannequin là gì?

Một bức ảnh chụp sản phẩm mà trong đó trang phục trông như đang lơ lửng, giữ nguyên phom dáng mà không lộ cơ thể hay móc treo. Nó hiển thị cùng lúc cả phom dáng lẫn cấu trúc bên trong, đó là lý do vì sao nó trở thành tiêu chuẩn mặc định trên các trang sản phẩm thời trang.

Tôi cần gửi gì đến endpoint?

Một bức ảnh chụp trang phục trên ma-nơ-canh. Ảnh mặt sau là tùy chọn nhưng sẽ giúp cải thiện việc tái tạo khi trang phục được mở cúc/khóa hoặc có thể mặc hai mặt.

Tôi nên chọn 3d hay flat lay?

Chọn 3d khi bạn muốn trang phục trông như đang được mặc — thể hiện rõ độ phồng, phần vai, tay áo. Chọn flat_lay khi danh sách sản phẩm yêu cầu phom dáng trải phẳng chính diện đồng nhất, điều mà các sàn thương mại điện tử thường áp dụng.

Một hình ảnh có chi phí bao nhiêu?

Trên Photta, 4 credits cho 2K và 5 credits cho 4K. Khi xử lý batch, mức giá cố định theo từng ảnh này sẽ được giữ trước cho toàn bộ lượt chạy.

Tôi có thể xử lý toàn bộ catalogue không?

Có, thông qua batch endpoint. Kích thước lô và số lượng lô có thể chạy cùng lúc phụ thuộc vào gói cước của bạn, vì vậy một catalogue lớn sẽ được thực thi dưới dạng một chuỗi các batch.

Đọc tiếp

Mọi số liệu trên trang này đều lấy từ tài liệu Photta API · đã kiểm tra

Chạy thử với một trang phục

Một ảnh chụp đưa vào, một ảnh ma-nơ-canh vô hình xuất ra.

Tạo tài khoản và lấy API keyXem endpoint
  • 1.5–4 min
  • 4 credits ở 2K · 5 credits ở 4K
  • async, polling