Hướng dẫn · Virtual try-on

API virtual try-on là gì? và những gì nó trả về

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

API virtual try-on nhận ảnh chụp trang phục và trả về hình ảnh trang phục đó được mặc trên người mẫu. Bạn POST ảnh cùng mannequin và pose, polling job, sau đó tải về kết quả.

Lấy API keyĐọc tài liệu
  • Thời gian điển hình: 1.5–4 min
  • Credits: 5 credits ở 2K · 6 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

Câu trả lời ngắn gọn

Một try-on API ảo là một HTTP endpoint dùng để render trang phục lên người mẫu. Bạn gửi ảnh chụp sản phẩm — thường là ảnh chụp trải sàn (flat lay) hoặc ảnh chụp trên ma-nơ-canh có sẵn — và dịch vụ sẽ trả về hình ảnh trang phục đó đang được mặc. Không cần studio, không cần thuê người mẫu, không cần chụp lại khi thay đổi phối màu.

Lệnh gọi này là bất đồng bộ vì thời gian render lâu hơn thời gian chờ của một request thông thường. Bạn POST thông tin trang phục cùng với người mẫu và tư thế mong muốn, API sẽ tiếp nhận tác vụ rồi trả về một id, sau đó bạn thực hiện polling một endpoint trạng thái cho đến khi tác vụ báo hoàn tất. Ảnh hoàn thiện được trả về dưới dạng một URL để bạn tự tải xuống và lưu trữ.

Các đối tượng thường tích hợp gồm có: đội ngũ quản lý catalogue cần hình ảnh trên người mẫu cho các sản phẩm chưa từng vào studio, các sàn thương mại điện tử nhận ảnh chụp phẳng từ người bán, và các ứng dụng cho phép người mua xem trang phục trên những vóc dáng khác ngoài người mẫu chuẩn duy nhất của thương hiệu.

Endpoint thực hiện tác vụ

Trích xuất trực tiếp từ tài liệu API Photta, không viết thủ công.

Tổng quan nhanh

Endpoint
POST /api/v1/tryon/apparel
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
5 credits ở 2K · 6 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 tiêu chí cần đánh giá ở bất kỳ API try-on nào

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

    Ảnh chụp trang phục dưới dạng https URL hoặc base64 data URI, kèm theo người mẫu và tư thế bạn muốn. Photta hỗ trợ JPEG, PNG và WebP với dung lượng tối đa 10 MB mỗi ảnh.

  • Thời gian xử lý

    Đủ lâu để không thể xử lý trọn vẹn trong một web request. Photta công bố thời gian hoàn thành thông thường cho từng endpoint và khuyến nghị polling mỗi 3 giây một lần — hệ thống không hỗ trợ webhook.

  • Chi phí sử dụng

    Photta tính phí bằng credits cho mỗi lượt gọi: 5 credits ở độ phân giải 2K và 6 credits ở 4K cho try-on trang phục; phí được trừ khi tác vụ bắt đầu và tự động hoàn lại nếu tác vụ thất bại.

  • Các giới hạn áp dụng

    Rate limit được công bố là 600 requests mỗi phút cho mỗi key, cùng với giới hạn số lượng tác vụ render đồng thời theo từng gói. Cả hai thông số này đều rất đáng đọc kỹ trước khi chạy xử lý cho toàn bộ catalogue.

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/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Câu hỏi về các API virtual try-on

Try-on API trả về dữ liệu gì?

Hình ảnh trang phục được mặc bởi người mẫu bạn đã chọn, được cung cấp dưới dạng một URL khi tác vụ hoàn thành. Hãy tải xuống và lưu trữ — URL trả về không phải là nơi lưu trữ vĩnh viễn.

Tôi có cần ảnh chụp người mẫu không?

Không. Photta cung cấp sẵn một catalogue ma-nơ-canh để bạn lựa chọn, ngoài ra bạn có thể tự tạo người mẫu từ các thuộc tính hoặc tự upload lên. Ảnh chụp trang phục là hình ảnh duy nhất bạn bắt buộc phải cung cấp.

Tính năng này khác gì so với phòng thử đồ ảo (virtual fitting room)?

Phòng thử đồ là tính năng hướng tới người mua hàng. Try-on API là bước render bên dưới tính năng đó: một lượt gọi vào, một hình ảnh ra. Bạn có thể xây dựng phòng thử đồ bên trên nó, hoặc đơn thuần chỉ dùng để sản xuất ảnh catalogue.

Một lượt gọi try-on tốn bao nhiêu chi phí?

Với Photta, chi phí là 5 credits ở 2K và 6 credits ở 4K. Các tác vụ thất bại sẽ được hoàn tiền, vì vậy chi phí retry chính là chi phí của bản thân lượt retry đó.

Thời gian tạo một hình ảnh mất bao lâu?

Endpoint có công bố thời gian hoàn thành thông thường, và tác vụ sẽ tự báo cáo trạng thái của nó. Hãy thực hiện poll mỗi 3 giây thay vì tự phỏng đoán thời gian.

Đọ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

Thử nghiệm trên ảnh sản phẩm của chính bạn

Một request, một lần poll, một hình ảnh.

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