Photta API
Photta API virtual try-on, ghost mannequin và chụp ảnh sản phẩm qua REST
Tóm tắt trong một câu
Photta API là REST API tính phí theo credits: POST ảnh sản phẩm tới endpoint tính năng, polling endpoint trạng thái của nó mỗi vài giây, tải về ảnh hoàn thiện. Tám tính năng, một key, một số dư credit duy nhất.
- Tính năng: 8 tính năng
- Rate limit: 600 requests/min
- Xác thực: Bearer key
- Pattern: 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
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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]Tính năng
Mọi endpoint, theo từng tính năng
Method, path, credits và thời gian xử lý thông thường, trích xuất trực tiếp từ tài liệu API. Số liệu trên trang này được đối soát với tài liệu theo ngày hiển thị ở cuối trang.
- POST/api/v1/tryon/apparel
Virtual Try-On (Trang phục)
Mặc trang phục trải phẳng (flat-lay) lên ma-nơ-canh AI với biểu cảm và kích cỡ cơ thể bạn chọn. Bốn loại sản phẩm, năm tỷ lệ khung hình.
5 credits ở 2K · 6 credits ở 4K1.5–4 min
Xem endpoint - POST/api/v1/tryon/jewelry
Jewelry Try-On
Ảnh chụp cận cảnh crop chặt dây chuyền, nhẫn, vòng tay và hoa tai trên ma-nơ-canh trang sức chuyên dụng — xử lý chuẩn xác phần phản chiếu và bề mặt siêu nhỏ.
5 credits ở 2K · 6 credits ở 4K1.5–4 min
Xem endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Tách bỏ ma-nơ-canh khỏi ảnh quần áo nhưng vẫn giữ nguyên vẹn cấu trúc bên trong. Hoàn thiện dạng 3D hoặc flat-lay, hỗ trợ xử lý hàng loạt.
4 credits ở 2K · 5 credits ở 4K1.5–4 min
Xem endpoint - POST/api/v1/ghost-mannequin/batch
Ghost Mannequin hàng loạt
Gửi toàn bộ giá treo ảnh trang phục chỉ trong một lệnh gọi và poll theo một batch ID duy nhất; từng hình ảnh được tính phí và theo dõi riêng biệt.
4 credits ở 2K · 5 credits ở 4K1.5–4 min per image
Xem endpoint - POST/api/v1/eyewear-studio
Eyewear Studio
Mắt kính và kính râm được render cận cảnh trên người mẫu, giữ đúng chuẩn gọng kính theo ảnh sản phẩm thực tế.
5 credits ở 2K · 6 credits ở 4K20–60 sec
Xem endpoint - POST/api/v1/detail-photos
Ảnh chi tiết
Ảnh chụp cận cảnh đường may, chất vải, phụ kiện kim loại và nhãn mác từ một ảnh sản phẩm duy nhất; bộ phân tích sẽ gợi ý các vùng cần chụp.
3 credits20–60 sec
Xem endpoint - POST/api/v1/mannequins/generate
Tạo ma-nơ-canh
Tạo ma-nơ-canh trang phục hoặc trang sức riêng từ các tùy chọn, sau đó tái sử dụng ID của chúng trong mọi lệnh gọi try-on.
4 credits30-60s
Xem endpoint - POST/api/v1/workflows/{workflow_id}
Workflows
Chạy một workflow định sẵn — ví dụ như ảnh hero shot cho trang sức — chỉ với một lệnh gọi và nhận về trọn bộ ảnh hoàn thiện.
4 credits ở 2K · 5 credits ở 4K20–60 sec / image
Xem endpoint
Ngôn ngữ
Chưa có SDK — và bạn cũng không cần đến nó.
Ba hướng dẫn sẵn sàng copy-paste, khớp chính xác với những gì tài liệu Photta khuyến nghị hiện tại.
Quickstart
Từ lúc đăng ký đến bức ảnh đầu tiên trong năm phút.
Mọi tính năng đều tuân theo cùng một luồng: xác thực, gửi job, polling. Học một lần là đủ.
Bước 1: Đăng ký tại ai.photta.app và tạo một API key live từ dashboard Developers.
Bước 2: POST job kèm key trong header Authorization — API trả về generation ID ngay lập tức.
Bước 3: Polling chính endpoint đó mỗi 3 giây cho đến khi status chuyển sang completed, sau đó tải về từ URL kết quả.
Câu hỏi thường gặp
Những điều lập trình viên thường hỏi trước khi đăng ký
Photta API là gì?
Photta API là dịch vụ REST tính phí theo credits, giúp tạo ảnh chụp thời trang chuyên nghiệp từ ảnh sản phẩm của bạn. Đây chính là pipeline vận hành các ứng dụng người dùng của Photta — virtual apparel try-on, jewelry try-on và tách ghost mannequin, được cung cấp dưới dạng tám tính năng để lập trình viên tự xây dựng công cụ riêng.
Làm thế nào để lấy API key?
Đăng ký tại ai.photta.app, mở mục Developers trên dashboard, nhấp vào Generate API key. Live key của bạn bắt đầu bằng `photta_live_` theo sau là 32 ký tự hex. Hãy lưu nó trong biến môi trường — tuyệt đối không commit lên source control, không gửi xuống browser.
Có gói miễn phí không?
Tài khoản mới sẽ nhận được credits dùng thử để trải nghiệm bất kỳ tính năng nào. Khi sẵn sàng triển khai thực tế, hãy đăng ký gói có hạn mức credit hàng tháng cao hơn. Rate limit đều như nhau trên mọi gói: 600 requests mỗi phút cho mỗi API key. Không yêu cầu mức sử dụng tối thiểu theo từng lệnh gọi.
Tốc độ tạo ảnh nhanh đến mức nào?
Các job try-on và ghost mannequin thường hoàn thành trong 1.5 đến 4 phút; ảnh kính mắt, ảnh chi tiết và ảnh quy trình trong 20 đến 60 giây; tạo mannequin trong 30 đến 60 giây. Mọi endpoint tạo ảnh đều là bất đồng bộ: POST trả về generation ID ngay lập tức, và bạn polling mỗi 3 đến 5 giây cho đến khi job hoàn tất. Không cần duy trì kết nối HTTP liên tục.
Đã có Photta SDK chính thức chưa?
Hiện tại chưa. Phương thức tích hợp được hỗ trợ là REST thuần qua cURL, fetch gốc của Node, hoặc thư viện requests của Python — cả ba đều có tài liệu hướng dẫn hoàn chỉnh từ đầu đến cuối trên trang này, cho từng tính năng.
Tài liệu tham khảo
Những phần trong tài liệu mà bạn sẽ cần mở lại nhiều lần.
Tài liệu tham khảo
Tạo ảnh Photta đầu tiên trong vòng chưa đầy năm phút.
Đăng ký, tạo API key, chạy lệnh cURL đầu tiên, polling cho đến khi hoàn thành, lưu trữ kết quả. Năm bước, có tài liệu hướng dẫn trọn gói từ đầu đến cuối.
ĐọcTài liệu tham khảo
Xác thực Photta API
Cách xác thực với Photta API: header Authorization, tiền tố key, nơi tạo key và cách xoay vòng key an toàn.
ĐọcTài liệu tham khảo
Bảng giá Photta API
Chi phí tính bằng credits cho từng endpoint của Photta API ở độ phân giải 2K và 4K, cơ chế trừ phí và hoàn tiền, cùng các endpoint miễn phí. Không tính giá tiền trực tiếp trên từng ảnh.
ĐọcTài liệu tham khảo
Rate limit của Photta API
Rate limit của Photta API, khung thời gian, header Retry-After, khoảng thời gian polling và giới hạn đồng thời theo từng gói, tất cả đều được lấy từ tài liệu API.
ĐọcTài liệu tham khảo
Mã lỗi Photta API
Danh sách đầy đủ các loại lỗi của Photta API kèm theo status code, cấu trúc body của lỗi, và những lỗi nào có thể thử lại.
ĐọcTài liệu tham khảo
Các endpoint tài nguyên của Photta API
Liệt kê ma-nơ-canh, tư thế, phông nền, giày dép và nhãn thương hiệu, tải lên nội dung của riêng bạn và xem số dư credit. Các tác vụ tra cứu đằng sau mọi lượt tạo.
ĐọcHướng dẫn
API virtual try-on là gì?
API virtual try-on render trang phục lên người mẫu từ một ảnh sản phẩm duy nhất. Yêu cầu đầu vào, dữ liệu trả về, chi phí và thời gian xử lý.
ĐọcHướng dẫn
Ghost mannequin API là gì?
Ghost mannequin API sẽ xóa ma-nơ-canh khỏi ảnh trang phục và tái tạo lại phần bên trong. Dữ liệu đầu vào, kết quả trả về và chi phí sử dụng.
ĐọcHướng dẫn
Di chuyển từ FASHN sang Photta
Những thay đổi khi bạn chuyển đổi tích hợp virtual try-on từ FASHN sang Photta: xác thực, request body, polling và cơ chế tính credits.
ĐọcXây dựng
Xây dựng với Photta API
Tám công thức toàn diện cho Photta API: ứng dụng try-on, ứng dụng Shopify, plugin WooCommerce, Django worker, xử lý catalog hàng loạt và tự động hóa no-code.
ĐọcSo sánh
Các API virtual try-on tốt nhất
Cách hoạt động của năm API virtual try-on — Photta, FASHN, FitRoom, Pixazo và Ayna. Những gì mỗi bên công bố, những gì không, và nơi xem chi tiết.
Đọc
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 API trong năm phút
Tạo một Photta API key, dán đoạn mã cURL ở trên, và bạn sẽ nhận được bức ảnh mẫu mặc đồ đầu tiên trước khi pha xong ly cà phê.
- 8 tính năng
- 600 requests/min
- Bearer key
- async, polling