Bắt đầu nhanh

Hình ảnh Photta đầu tiên trong chưa đầy năm phút.

Một tài khoản duy nhất, một API key duy nhất, năm lệnh shell. Các bước dưới đây khớp chính xác với những gì tài liệu chính thức của Photta khuyến nghị — không wrapper, không SDK, không giả định framework.

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

Đăng ký tại ai.photta.app, nhấp Tạo API key, export thành PHOTTA_API_KEY, POST tới /api/v1/tryon/apparel và poll ID tạo ảnh nhận được mỗi 3 giây cho đến khi status chuyển sang completed — thường trong vòng 1.5 đến 4 phút.

Cách hoạt động

Năm lệnh từ con số không đến hình ảnh đầu tiên

Dán chúng vào terminal theo thứ tự. Mỗi đoạn mã đều độc lập và chỉ sử dụng curl + jq.

  1. 01

    Bước 1

    Tạo API key

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

    # Sign up at ai.photta.app, open the Developers dashboard,
    # click "Generate API key" and copy it into your env.
    export PHOTTA_API_KEY="photta_live_xxxxx"
    export PHOTTA_BASE_URL="https://ai.photta.app/api/v1"
  2. 02

    Bước 2

    POST yêu cầu thử đồ đầu tiên

    Gọi /api/v1/tryon/apparel với URL ảnh sản phẩm, ID ma-nơ-canh và ID tư thế. API trả lời 202 Accepted ngay lập tức và trả về một ID tạo ảnh trong data.id.

    curl -X POST "$PHOTTA_BASE_URL/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"
      }'
    # Response: 202 Accepted + data.id (generation ID)
  3. 03

    Bước 3

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

    GET /api/v1/tryon/apparel/:id mỗi 3 giây. Thời gian hoàn thành thông thường là 1.5–4 phút. Hãy đặ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 mãi mãi.

    # Loop every 3 seconds until status flips to "completed".
    # Typical completion: 1.5–4 minutes. Max 120 attempts = 6 min.
    for i in $(seq 1 120); do
      RESULT=$(curl -s "$PHOTTA_BASE_URL/tryon/apparel/$ID" \
        -H "Authorization: Bearer $PHOTTA_API_KEY")
      STATUS=$(echo "$RESULT" | jq -r '.data.status')
      [ "$STATUS" = "completed" ] && break
      [ "$STATUS" = "failed" ] && echo "Job failed" && exit 1
      sleep 3
    done
  4. 04

    Bước 4

    Lưu trữ kết quả đầu ra

    Khi status chuyển sang completed, data.output_url chứa hình ảnh đã render. Tải dữ liệu về bộ lưu trữ của riêng bạn để sản phẩm không phụ thuộc vào CDN của Photta.

    # Pull the final URL out of the response and save the bytes.
    OUTPUT_URL=$(echo "$RESULT" | jq -r '.data.output_url')
    curl -sO "$OUTPUT_URL"
    echo "Saved $(basename "$OUTPUT_URL")"
  5. 05

    Bước 5

    Xử lý các trường hợp lỗi một cách minh bạch

    Phân nhánh dựa trên mã trạng thái HTTP: 402 cho thiếu credit, 429 cho giới hạn tốc độ (tuân thủ Retry-After), 5xx cho lỗi máy chủ tạm thời. Mọi phản hồi lỗi đều mang mã error.code máy có thể đọc được để bạn xử lý.

    # Surface the common failure modes honestly.
    case "$STATUS_CODE" in
      402) echo "Out of credits — top up at ai.photta.app" ;;
      429) echo "Rate limited — honour Retry-After header" ;;
      4??) echo "Client error: $(echo "$BODY" | jq '.error.message')" ;;
      5??) echo "Server error — retry with backoff" ;;
    esac

Câu hỏi từ các nhà phát triển khác

Câu hỏi về việc bắt đầu

Quá trình bắt đầu nhanh mất bao lâu?+

Năm phút cho việc đăng ký + tạo key + lệnh cURL đầu tiên. Việc tạo ảnh mất từ 1.5 đến 4 phút, vì vậy hãy dự tính khoảng mười phút thời gian thực trước khi bạn thấy hình ảnh người mẫu đầu tiên.

Tôi có cần thẻ tín dụng để dùng thử không?+

Các tài khoản mới đi kèm với credit dùng thử để bạn trải nghiệm trước khi thanh toán. Khi sẵn sàng triển khai thực tế, hãy đăng ký gói thuê bao để có số dư credit hàng tháng cao hơn và giới hạn tốc độ nhanh hơn.

Tôi nên thử endpoint nào trước?+

Thử đồ quần áo (/api/v1/tryon/apparel) — đây là endpoint được sử dụng rộng rãi nhất, tài liệu đầy đủ nhất và nó bao quát mô hình bất đồng bộ + polling mà mọi endpoint Photta khác đều sử dụng lại. Khi đã quen, tính năng trang sức và Ghost Mannequin cũng hoạt động tương tự.

Tôi có thể chạy từ trình duyệt không?+

Không. API key của bạn phải được giữ ở phía server — đưa nó vào trình duyệt sẽ làm lộ key cho mọi khách truy cập. Hãy chuyển hướng các cuộc gọi qua một proxy mỏng trên backend của bạn (Next.js route handler, Express, Flask, Lambda) và để trình duyệt giao tiếp với proxy đó.

Bắt đầu nhanh

Bạn chỉ còn cách hình ảnh đầu tiên năm phút

Photta API Quickstart — Hình ảnh đầu tiên trong 5 phút | Photta