Khả năng · Tạo mannequin

API tạo mannequin bằng AI cho người mẫu của riêng bạn

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

API tạo mannequin của Photta xây dựng người mẫu AI chân thực từ các thuộc tính bạn chọn, trả về một mannequin id có thể tái sử dụng và tốn 4 credits. Hai bộ builder: một cho trang phục, một được tinh chỉnh cho ảnh chụp cận cảnh trang sức.

  • Thời gian điển hình: 30-60s
  • Credits: 4 credits
  • Xử lý: async, polling
  • Giới hạn: 600 requests/min
  • Xác thực: Bearer key

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

POST/api/v1/mannequins/generate
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/generate \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "Female",
  "ethnicity": "east_asian_korean",
  "age": "late_20s",
  "skin_tone": "light_medium",
  "expression": "neutral",
  "hair_style": "long_straight",
  "hair_color": "black",
  "body_type": "slim",
  "height": "average"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Tổng quan nhanh

Tổng quan nhanh

Endpoint
POST /api/v1/mannequins/generate
Xác thực
Bearer API key
Xử lý
Bất đồng bộ — polling status endpoint
Thời gian điển hình
30-60s
Credits
4 credits
Giới hạn đầu vào
Tối đa 10 MB mỗi ảnh; JPEG, PNG, WebP
Idempotent
Không

Request và response

Request

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/generate \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "Female",
  "ethnicity": "east_asian_korean",
  "age": "late_20s",
  "skin_tone": "light_medium",
  "expression": "neutral",
  "hair_style": "long_straight",
  "hair_color": "black",
  "body_type": "slim",
  "height": "average"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

202 Accepted / Completed

{
  "data": {
    "id": "mmk_r4s5t6",
    "status": "processing",
    "category": "Female",
    "credits_used": 4,
    "created_at": "2026-04-10T14:00:00Z"
  },
  "request_id": "req_mnk002"
}

Tham số request

category

Kiểu: stringBắt buộc

Mannequin category.

Giá trị: FemaleMaleGirlChildBoyChild
ethnicity

Kiểu: string

Ethnic appearance.

Giá trị: east_asian_koreaneast_asian_chinesesoutheast_asiansouth_asiannordicwestern_europeaneastern_europeanmediterraneanafricanafrican_americanmiddle_easternlatin_americanbrazilianmixed_asian_europeanpolynesian
age

Kiểu: string

Age range.

Giá trị: early_20slate_20searly_30slate_30s40s50sbaby_1toddler_2_4young_5_7child_8_10preteen_11_13
skin_tone

Kiểu: string

Skin tone.

Giá trị: lightlight_mediummediummedium_darkdark
face_shape

Kiểu: string

Face shape.

Giá trị: ovalsquareroundheartoblongdiamond
eye_color

Kiểu: string

Eye color.

Giá trị: browndark_brownblackbluegreenhazelgrayamber
eye_shape

Kiểu: string

Eye shape.

Giá trị: almondroundmonolidhoodedupturneddownturned
expression

Kiểu: string

Facial expression.

Giá trị: neutralsoft_smilewarm_smileseriousconfidentfriendly
facial_hair

Kiểu: string

Facial hair style (Male only).

Giá trị: nonelight_stubblemedium_stubbleshort_beardfull_beardgoateemustache
makeup

Kiểu: string

Makeup style (Female only).

Giá trị: naturalminimalsoft_glamprofessionaleditorial
hair_style

Kiểu: string

Hair style. Available options depend on category — use /options endpoint.

hair_color

Kiểu: string

Hair color.

Giá trị: blackdark_brownmedium_brownlight_brownauburnredblondeplatinum_blondegraywhite
hair_texture

Kiểu: string

Hair texture.

Giá trị: straightwavycurlycoily
body_type

Kiểu: string

Body type. Options depend on category — use /options endpoint.

height

Kiểu: string

Height.

Giá trị: shortaveragetall
glasses

Kiểu: string

Glasses.

Giá trị: noneeyeglassessunglasses
freckles

Kiểu: string

Freckles.

Giá trị: nonelightprominent
piercings

Kiểu: string

Piercings.

Giá trị: noneearnosemultiple

Lỗi

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

Giới hạn

  • 600 request mỗi phút trên mỗi API key (Fixed window; giới hạn như nhau trên mọi gói)
  • Mã 429 kèm header Retry-After: 30 giây
  • Tối đa 10 MB mỗi ảnh
  • Định dạng: JPEG, PNG, WebP
  • Batch đồng thời theo từng gói: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Chỉ hỗ trợ polling — API không gửi webhook.

Đưa thuộc tính vào, nhận người mẫu tái sử dụng được ra

Đọc options, chọn thuộc tính, gửi request, polling, sau đó tái sử dụng id.

  1. Bước 1

    Tạo API key

    Tạo mannequin sử dụng cùng thông tin xác thực và cùng số dư credit như mọi tính năng khác của Photta.

  2. Bước 2

    Đọc danh mục option

    GET `/api/v1/mannequins/generate/options` trả về mọi giá trị được chấp nhận, bao gồm danh sách `hair_style` và `body_type` khác nhau theo từng danh mục. Hãy điều khiển form của bạn từ endpoint này thay vì hardcode các enum.

  3. Bước 3

    POST mannequin

    POST `/api/v1/mannequins/generate` với `category` — `Female`, `Male`, `GirlChild` hoặc `BoyChild` — cùng với bất kỳ thuộc tính nào trong 17 thuộc tính tùy chọn: chủng tộc, độ tuổi, tông da, dáng mặt và dáng mắt, biểu cảm, râu, trang điểm, kiểu tóc, vóc dáng, chiều cao, kính mắt, tàn nhang và khuyên xỏ.

  4. Bước 4

    Polling cho đến khi tác vụ hoàn thành

    GET `/api/v1/mannequins/generate/:id` mỗi 3 giây cho đến khi `data.status` là `completed` hoặc `failed`; thời gian hoàn thành thông thường là 30 đến 60 giây.

  5. Bước 5

    Tái sử dụng mannequin

    Body trả về khi hoàn tất chứa một object `mannequin` kèm id riêng của nó. Hãy truyền id đó vào tham số `mannequin_id` trong các tác vụ try-on hoặc kính mắt sau này và mọi bức ảnh đều giữ nguyên cùng một khuôn mặt.

Các câu hỏi lập trình viên thường đặt ra trước khi tạo người mẫu

Mannequin AI là gì?

Một người mẫu được tạo tự động mà bạn chỉ định ngoại hình thay vì phải tuyển chọn diễn viên. Kết quả trả về dưới dạng một id, nhờ đó cùng một khuôn mặt, mái tóc và vóc dáng có thể mặc mọi trang phục trong catalog.

Chi phí cho một mannequin là bao nhiêu?

4 credits, áp dụng cho cả builder trang phục và builder trang sức. Việc tái sử dụng mannequin đã có trong buổi chụp sau không tốn thêm chi phí — bạn trả phí cho lượt try-on, không phải cho người mẫu.

Tôi có thể thiết lập những thuộc tính nào?

`category` là bắt buộc. Mọi thông số khác là tùy chọn: chủng tộc, độ tuổi, tông da, dáng mặt, màu và dáng mắt, biểu cảm, râu, trang điểm, kiểu tóc, màu và kết cấu tóc, vóc dáng, chiều cao, kính mắt, tàn nhang và khuyên xỏ. Endpoint options liệt kê toàn bộ các giá trị được chấp nhận.

Bộ builder trang sức dùng để làm gì?

POST `/api/v1/mannequins/jewelry/generate` tạo người mẫu được tinh chỉnh cho các bức ảnh chụp cận cảnh trang sức: endpoint nhận `jewelry_type`, `shot_type`, `camera_angle`, `background` và `lighting` thay vì các thuộc tính toàn thân, giúp phần cổ áo, tai hoặc bàn tay hiển thị chính xác ở cự ly gần.

Tôi có thể tái sử dụng cùng một người mẫu qua các buổi chụp khác nhau không?

Có — đó chính là mục đích của endpoint này. Mannequin id được tạo ra sẽ được chấp nhận làm `mannequin_id` cho try-on trang phục, try-on trang sức và studio kính mắt.

Làm thế nào để polling kết quả?

GET `/api/v1/mannequins/generate/:id` mỗi 3 giây cho đến khi `data.status` là `completed` hoặc `failed`. Trình tạo trang sức polling đường dẫn trạng thái riêng của nó.

Các tính năng liên quan

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

  • 30-60s
  • 4 credits
  • async, polling
  • 600 requests/min
  • Bearer key