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')

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.

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à đủ.

  1. Bước 1: Đăng ký tại ai.photta.app và tạo một API key live từ dashboard Developers.

  2. Bước 2: POST job kèm key trong header Authorization — API trả về generation ID ngay lập tức.

  3. 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ả.

Bắt đầu nhanh

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.

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