Apparel · Tính năng

Virtual Try-On API — Photta

Chỉ với một lệnh gọi REST, biến ảnh quần áo trải sàn thành ảnh người mẫu chuyên nghiệp. Bất đồng bộ, 1.5–4 phút mỗi lần tạo, 5 credits cho 2K hoặc 7 credits cho 4K.

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

Virtual Try-On API của Photta nhận một ảnh quần áo trải sàn, một mannequin_id và một pose_id, sau đó trả về ảnh người mẫu 2K hoặc 4K. Bạn xác thực bằng `Authorization: Bearer photta_live_xxx`, POST tới `/api/v1/tryon/apparel`, poll cùng endpoint đó với ID tạo ảnh nhận được mỗi 3–5 giây, và tải kết quả khi status chuyển sang `completed`.

Lấy API key→Đọc tài liệu

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Kỳ vọng gì

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Code toàn quy trình

Chọn ngôn ngữ của bạn

Cùng một endpoint, ba hướng dẫn có thể chạy ngay. Mọi đoạn code đều khớp với tài liệu chính thức của Photta.

SDK

→

Node.js

Sử dụng fetch gốc trong Node 18+ · Sẵn sàng cho Next.js server actions

SDK

→

Python

requests + wrapper 30 dòng · Django / FastAPI / Celery

SDK

→

cURL

Kiểm tra shell trong hai phút · pipeline jq · không cần cài đặt

Cách hoạt động

Bốn lệnh gọi API, một ảnh sản phẩm

Chọn một ma-nơ-canh và tư thế, gửi tác vụ, poll cho đến khi xong, tải kết quả.

01
Bước 1
Tạo API key
Đăng ký tại ai.photta.app, mở tab Nhà phát triển, nhấp Tạo API key. Live key bắt đầu bằng `photta_live_`. Đặt key vào `PHOTTA_API_KEY` — đừng bao giờ commit nó.
02
Bước 2
Chọn ma-nơ-canh và tư thế
Sử dụng GET `/api/v1/mannequins` và `/api/v1/poses` để liệt kê các tùy chọn. Chọn các ID phù hợp với thương hiệu của bạn — kích thước cơ thể, biểu cảm, sắc tộc và danh mục tư thế đều có thể lọc được.
03
Bước 3
POST tác vụ thử đồ
Gửi yêu cầu POST tới `/api/v1/tryon/apparel` với `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. API sẽ trả về 202 Accepted kèm theo một ID tạo ảnh.
04
Bước 4
Poll cho đến khi tác vụ hoàn thành
GET tới `/api/v1/tryon/apparel/:id` mỗi 3 giây. Khi `data.status` chuyển sang `completed`, payload sẽ bao gồm `output_url` và `thumbnail_url`. Hãy đặt giới hạn tối đa để tác vụ bị kẹt không làm treo yêu cầu của bạn.
05
Bước 5
Tải về và lưu trữ
Lấy dữ liệu từ `output_url` và lưu trữ trong kho lưu trữ đối tượng của riêng bạn. URL CDN ổn định nhưng sản phẩm của bạn không nên phụ thuộc vào nó để hiển thị.

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ử đồ quần áo

Virtual Try-On API của Photta là gì?+

Một endpoint REST nhận ảnh sản phẩm trải sàn và một cặp ID (ma-nơ-canh + tư thế) và trả về ảnh người mẫu chân thực. Cùng quy trình xử lý với ứng dụng tiêu dùng của Photta. Sáu loại sản phẩm được hỗ trợ: áo, quần/váy, bộ áo+quần, váy liền, đồ liền thân (one-piece), jumpsuit.

Chi phí mỗi lần gọi là bao nhiêu?+

5 credits cho kết quả 2K, 7 credits cho 4K. Credit đi kèm với gói thuê bao của bạn và có thể nạp thêm. Các lần tạo ảnh thất bại không tốn credit — chúng sẽ được hoàn lại.

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

Thời gian hoàn thành thông thường là 1.5 đến 4 phút, đo lường toàn quy trình. Lệnh POST trả về ID tạo ảnh trong chưa đầy một giây; công việc của GPU diễn ra ngầm trong khi bạn thực hiện poll.

Những loại sản phẩm nào được hỗ trợ?+

Sáu loại: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Mỗi loại yêu cầu cấu trúc `product_images` khác nhau — ví dụ `top_and_bottom` yêu cầu cả URL `top_image` và `bottom_image`.

Tôi có thể sử dụng ma-nơ-canh của riêng mình không?+

Có. Tải ảnh ma-nơ-canh lên `/api/v1/mannequins/upload` hoặc tạo ma-nơ-canh AI mới với `/api/v1/mannequins/generate-model`. ID trả về có thể dùng trực tiếp trong yêu cầu thử đồ.

Làm thế nào để poll kết quả?+

GET tới `/api/v1/tryon/apparel/:id` mỗi 3 đến 5 giây cho đến khi `data.status` là `completed` hoặc `failed`. Hãy giới hạn số lần thử — 120 lần × 3s là đủ để bao quát khoảng thời gian được tài liệu ghi nhận.

Liên quan