Tạo ảnh Photta đầu tiên trong vòng chưa đầy năm phút.

1. 1

   Bước 1

   Tạo một API key

   Đăng ký tại ai.photta.app và mở dashboard Developers. Nhấn Generate API key — live key sẽ bắt đầu bằng photta_live_. Export key để phần hướng dẫn tiếp theo có thể đọc được từ shell của bạn.

   cURL

   Sao chép

   # https://ai.photta.app → Developers → Generate API key
   export PHOTTA_API_KEY="photta_live_xxxxx"
   export PHOTTA_BASE_URL="https://api.photta.app/api/v1"

2. 2

   Bước 2

   POST lượt try-on đầu tiên của bạn

   Gửi request tới /api/v1/tryon/apparel kèm URL ảnh sản phẩm và mannequin ID. API sẽ phản hồi 202 Accepted ngay lập tức và trả về generation ID trong data.id.

   cURL

   Sao chép

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

3. 3

   Bước 3

   Polling cho đến khi hoàn thành

   GET /api/v1/tryon/apparel/:id mỗi 3 giây một lần. Thời gian hoàn thành thông thường là 1.5–4 phút. Đặt giới hạn số lần thử để tác vụ bị kẹt không làm treo script của bạn vô thời hạn.

   cURL

   Sao chép

   # $ID is data.id from the POST response. Poll every 3 seconds until status is "completed" or "failed".
   for i in $(seq 1 120); do
     RESULT=$(curl -s "https://api.photta.app/api/v1/tryon/apparel/$ID" -H "Authorization: Bearer $PHOTTA_API_KEY")
     STATUS=$(echo "$RESULT" | jq -r '.data.status')
     [ "$STATUS" = "completed" ] && break
     [ "$STATUS" = "failed" ] && echo "generation failed" && exit 1
     sleep 3
   done
   echo "$RESULT" | jq -r '.data.output_url'

4. 4

   Bước 4

   Lưu trữ dữ liệu đầu ra

   Khi status chuyển sang completed, data.output_url sẽ chứa hình ảnh đã kết xuất. Hãy tải các byte dữ liệu này về bộ lưu trữ của riêng bạn để sản phẩm của bạn không bị phụ thuộc vào CDN của Photta khi kết xuất.

   cURL

   Sao chép

   OUTPUT_URL=$(echo "$RESULT" | jq -r '.data.output_url')
   curl -sO "$OUTPUT_URL"
   echo "Saved $(basename "$OUTPUT_URL")"

5. 5

   Bước 5

   Xử lý thỏa đáng các trường hợp lỗi

   Rẽ nhánh xử lý dựa trên HTTP status code: 402 cho lỗi không đủ credits, 429 khi vượt rate limits (tuân thủ Retry-After), 5xx cho các lỗi máy chủ tạm thời. Mỗi thân phản hồi lỗi đều chứa error.code dưới định dạng máy có thể đọc được để bạn xử lý theo chương trình.

   cURL

   Sao chép

   case "$STATUS_CODE" in
     402) echo "insufficient_credits_error — top up before retrying" ;;
     429) echo "rate_limit_error — wait the Retry-After seconds (30 by default)" ;;
     4??) echo "$BODY" | jq '.error.type, .error.message' ;;
     5??) echo "api_error — retry with backoff" ;;
   esac

• Tính năng

  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.

  Đọc

• Tính năng

  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ỏ.

  Đọc

• Tính năng

  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.

  Đọc

• Tính năng

  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ế.

  Đọc

• Tính năng

  Ả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.

  Đọc

• Tính năng

  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.

  Đọc

• Tính năng

  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.

  Đọc

• Tính năng

  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.

  Đọc

• API

  Photta API

  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.

  Đọc

Mọi số liệu trên trang này đều lấy từ tài liệu Photta API · đã kiểm tra 2026-09-10