Photta API

Nhiếp ảnh thời trang AI, chỉ với một lệnh gọi REST.

Tạo ảnh quần áo và trang sức trên người mẫu, xóa ma-nơ-canh từ ảnh chụp trải sàn và xây dựng studio thời trang AI của riêng bạn dựa trên quy trình sản xuất của Photta — các endpoint REST bất đồng bộ, tính phí theo credit, tài liệu ưu tiên cURL.

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

Tính năng

3

Auth

Bearer

Pattern

Bất đồng bộ + poll

Typical

1–4 min

Tính năng

Ba endpoint, một tài khoản, một số dư credit.

Mọi tính năng đều dùng chung phương thức xác thực, mô hình polling và cấu trúc lỗi — chỉ cần học một, triển khai cả ba.

POST/api/v1/tryon/apparel

Thử đồ ảo (Apparel)

Đặt trang phục từ ảnh trải sàn lên ma-nơ-canh AI với tư thế, biểu cảm và kích thước cơ thể bạn chọn. Sáu loại sản phẩm, năm tỷ lệ khung hình.

5 / 7 credits·~3 min
View capability →
POST/api/v1/tryon/jewelry

Thử trang sức (Jewelry)

Ảnh chụp cận cảnh vòng cổ, nhẫn, vòng tay và hoa tai trên các ma-nơ-canh trang sức chuyên dụng — xử lý tốt các bề mặt phản chiếu và chi tiết nhỏ.

5 / 7 credits·~3 min
View capability →
POST/api/v1/ghost-mannequin

Ghost Mannequin

Tách ma-nơ-canh khỏi ảnh trang phục và giữ nguyên cấu trúc bên trong. Hoàn thiện theo kiểu Hollow-man hoặc trải sàn, thân thiện với xử lý hàng loạt.

4 / 6 credits·~2 min
View capability →

Ngôn ngữ

Chưa có SDK — và bạn cũng không cần đến nó.

Ba hướng dẫn chi tiết có thể dán và chạy ngay, khớp chính xác với những gì tài liệu Photta khuyến nghị hiện nay.

javascript

→

Node.js

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

python

→

Python

Thư viện requests + wrapper 30 dòng. Hoạt động tốt trong Django, FastAPI, Celery, Lambda.

bash

→

cURL

Kiểm tra nhanh trong hai phút cho bất kỳ endpoint nào. Kết hợp với jq cho các shell pipeline.

Bắt đầu nhanh

Từ khi đăng ký đến hình ảnh đầu tiên trong năm phút.

Mọi tính năng đều tuân theo cùng một mô hình: xác thực, gửi yêu cầu, poll. Chỉ cần học một lần.

  • 1Đăng ký tại ai.photta.app và tạo một live API key từ dashboard Nhà phát triển.
  • 2POST tác vụ với key của bạn trong Authorization header — API sẽ trả về một ID tạo ảnh ngay lập tức.
  • 3Poll cùng endpoint đó mỗi 3 giây cho đến khi status chuyển sang completed, sau đó tải kết quả từ URL.
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": ["..."],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K"
  }'

Câu hỏi

Điều các nhà phát triển thắc mắc trước khi đăng ký

Photta API là gì?+

Photta API là một dịch vụ REST tính phí theo credit giúp tạo ảnh thời trang chuyên nghiệp từ ảnh sản phẩm của bạn. Đây chính là quy trình vận hành các ứng dụng tiêu dùng của Photta — thử quần áo ảo, thử trang sức và tách Ghost Mannequin, được cung cấp dưới dạng ba endpoint để các nhà phát triể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ở phần Nhà phát triển trên dashboard, nhấp vào Tạo 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 — đừng bao giờ commit vào source control hoặc đưa vào trình duyệt.

Có gói miễn phí không?+

Các tài khoản mới sẽ nhận được credit dùng thử để trải nghiệm bất kỳ tính năng nào. Khi bạn đã sẵn sàng triển khai, hãy đăng ký gói thuê bao với số dư credit hàng tháng cao hơn và giới hạn tốc độ nhanh hơn (30/min Starter, 60/min Pro). Không yêu cầu mức tối thiểu mỗi lần gọi; credit chưa sử dụng sẽ không hết hạn trong chu kỳ thanh toán.

Tốc độ tạo ảnh là bao nhiêu?+

Các tác vụ thử đồ thường hoàn thành trong vòng 1.5 đến 4 phút. Ghost Mannequin nhanh hơn — thường từ 1 đến 3 phút. Mọi endpoint đều là bất đồng bộ: lệnh POST trả về ID tạo ảnh trong chưa đầy một giây, và bạn thực hiện poll mỗi 3 đến 5 giây cho đến khi tác vụ hoàn thành. Không cần duy trì kết nối HTTP lâu.

Có SDK Photta chính thức không?+

Chưa có. Lộ trình tài liệu dự kiến sẽ có Python SDK khi đạt mười khách hàng API hoạt động và Node.js SDK khi đạt hai mươi. Cho đến lúc đó, lộ trình tích hợp được hỗ trợ là REST thô qua cURL, native fetch của Node hoặc thư viện requests của Python — cả ba đều được hướng dẫn chi tiết trên trang này.

Photta API

Dùng thử 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ẽ có hình ảnh đầu tiên trên người mẫu trước khi cà phê kịp pha xong.

Lấy API key →Đọc tài liệu
Photta API — Nhiếp ảnh thời trang AI cho nhà phát triển | Photta