Jewelry · Tính năng
Jewelry Try-On API — Photta
Vòng cổ, nhẫn, vòng tay và hoa tai được đặt trên người mẫu AI chụp cận cảnh, với khả năng xử lý được tinh chỉnh cho các bề mặt nhỏ và phản chiếu mạnh. Cùng mức giá 2K/4K như quần áo, cùng mô hình bất đồng bộ.
Tóm tắt trong một câu
Jewelry Try-On API của Photta nhận một ảnh trang sức kèm theo `jewelry_type` (necklace, ring, bracelet hoặc earrings) và trả về ảnh người mẫu chụp cận cảnh. POST tới `/api/v1/tryon/jewelry` với `Authorization: Bearer photta_live_xxx`, poll ID nhận được mỗi 3 giây, và tải kết quả khi status chuyển sang `completed`.
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_type": "necklace",
"jewelry_images": ["https://example.com/necklace.jpg"],
"mannequin_id": "mnq_jewelry_close_01",
"resolution": "2K",
"aspect_ratio": "1:1"
}'Kỳ vọng gì
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
Code toàn quy trình
Chọn ngôn ngữ của bạn
Cùng ba hướng dẫn — chỉ cần thay đổi endpoint và body của yêu cầu.
Cách hoạt động
Quy trình quần áo được tinh chỉnh cho các vật phẩm nhỏ, phản chiếu mạnh
Chọn ma-nơ-canh cận cảnh, gửi yêu cầu, poll, tải về.
- 01
Bước 1
Tạo API key
Quy trình giống như với quần áo — ai.photta.app → Nhà phát triển → Tạo API key. Một key hoạt động trên mọi endpoint; một số dư credit bao quát mọi tính năng.
- 02
Bước 2
Chọn ma-nơ-canh cận cảnh
Lọc `/api/v1/mannequins?jewelry_type=necklace` (hoặc ring / bracelet / earrings) — Photta duy trì một bộ ma-nơ-canh cận cảnh chuyên dụng với kết cấu da được tinh chỉnh cho kim loại và đá quý nhỏ.
- 03
Bước 3
POST tác vụ trang sức
POST tới `/api/v1/tryon/jewelry` với `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Dịch vụ sẽ tự động căn chỉnh vị trí cho từng loại trang sức.
- 04
Bước 4
Poll cho đến khi tác vụ hoàn thành
GET tới `/api/v1/tryon/jewelry/:id` mỗi 3 giây. Cấu trúc phản hồi giống hệt với quần áo — `data.status`, `data.output_url`, `data.thumbnail_url`.
- 05
Bước 5
Tải về và lưu trữ
Ảnh cắt cận cảnh 1:1 hoạt động tốt nhất cho thumbnail trang sản phẩm (PDP); tỷ lệ khung hình rộng hơn dùng cho ảnh biên tập. Hãy tự lưu trữ dữ liệu thay vì hot-link trực tiếp từ CDN.
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 thử trang sức
Những loại trang sức nào được hỗ trợ?+
Bốn danh mục rõ rệt: vòng cổ (necklace), nhẫn (ring), vòng tay (bracelet), hoa tai (earrings). Mỗi danh mục có bộ ma-nơ-canh cận cảnh chuyên dụng và thuật toán căn chỉnh riêng. Nhẫn và hoa tai đạt hiệu quả tốt nhất ở tỷ lệ khung hình 1:1; vòng cổ hiển thị đẹp ở tỷ lệ 3:4.
Chi phí thử trang sức là bao nhiêu?+
Giống như quần áo: 5 credits cho 2K, 7 credits cho 4K. Các tác vụ thất bại sẽ được hoàn lại tự động. Không có phụ phí cho thư viện ma-nơ-canh cận cảnh.
Endpoint trang sức khác gì với quần áo?+
Cùng phương thức xác thực, cùng mô hình polling, cùng cấu trúc phản hồi — sự khác biệt nằm ở request body. Bạn gửi `jewelry_type` và `jewelry_images` thay vì `product_type` và `product_images`, và chọn ma-nơ-canh được lọc theo danh mục trang sức. Mọi thứ khác (2K/4K, tỷ lệ khung hình, credit) đều dùng chung.
Tôi có thể tải lên mẫu trang sức của riêng mình không?+
Có — `/api/v1/jewelry-mannequins/upload` nhận ảnh tham chiếu cận cảnh tùy chỉnh, `/api/v1/jewelry-mannequins/generate` tạo mẫu mới từ prompt. Cả hai đều trả về ID để bạn đưa vào yêu cầu thử đồ.
Dịch vụ xử lý kim loại phản chiếu và đá quý như thế nào?+
Quy trình cận cảnh mang theo metadata về các điểm nhấn phản xạ (specular highlights) và cấu trúc vi mô. Vàng, bạc và bạch kim đánh bóng gương sẽ hiển thị chính xác mà không bị hiện tượng bóng ma hay nhòe sắc ký như các quy trình thử đồ thông thường. Khuyến nghị sử dụng ảnh gốc trên nền studio siêu sạch để có kết quả tốt nhất.
Làm thế nào để poll kết quả?+
GET tới `/api/v1/tryon/jewelry/:id` mỗi 3 đến 5 giây. Cùng vòng đời status như quần áo: `processing` → `completed` hoặc `failed`. Khoảng thời gian từ 1.5 đến 4 phút bao quát đại đa số các tác vụ.
Liên quan
Các tính năng liên quan
Jewelry · Tính năng
Tạo tài khoản và lấy API key
Jewelry Try-On API của Photta nhận một ảnh trang sức kèm theo `jewelry_type` (necklace, ring, bracelet hoặc earrings) và trả về ảnh người mẫu chụp cận cảnh. POST tới `/api/v1/tryon/jewelry` với `Authorization: Bearer photta_live_xxx`, poll ID nhận được mỗi 3 giây, và tải kết quả khi status chuyển sang `completed`.