Kapabilitas · Pembuatan manekin

API pembuatan manekin AI untuk model Anda sendiri

Ringkasan singkat

API pembuatan manekin Photta membangun model AI fotorealistis dari atribut yang Anda pilih, mengembalikan id manekin yang dapat digunakan kembali, dan berbiaya 4 credits. Dua pembangun: satu untuk pakaian, satu disesuaikan untuk close-up perhiasan.

Dapatkan API key Baca dokumentasi

Waktu umum: 30-60s
Credits: 4 credits
Pemrosesan: async, polling
Batasan: 600 requests/min
Autentikasi: Bearer key

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa 2026-09-10

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

const res = await fetch("https://api.photta.app/api/v1/mannequins/generate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/generate",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "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"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Sekilas

Endpoint: POST /api/v1/mannequins/generate
Autentikasi: API key Bearer
Pemrosesan: Asinkron — lakukan polling ke endpoint status
Waktu umum: 30-60s
Credits: 4 credits
Batas input: Hingga 10 MB per gambar; JPEG, PNG, WebP
Idempoten: Tidak

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

const res = await fetch("https://api.photta.app/api/v1/mannequins/generate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/generate",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "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"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

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"
}

{
  "data": {
    "id": "mmk_r4s5t6",
    "status": "completed",
    "mannequin": {
      "id": "mnk_v7w8x9",
      "name": "Generated Mannequin",
      "gender": "female",
      "thumbnail_url": "https://cdn.photta.app/mannequins/mnk_v7w8x9-thumb.jpg"
    },
    "credits_used": 4,
    "created_at": "2026-04-10T14:00:00Z",
    "completed_at": "2026-04-10T14:00:42Z",
    "duration_ms": 42000
  },
  "request_id": "req_mnk003"
}

Parameter request

FieldDeskripsi

category Tipe: stringWajib: Mannequin category.
Nilai: FemaleMaleGirlChildBoyChild
ethnicity Tipe: string: Ethnic appearance.
Nilai: east_asian_koreaneast_asian_chinesesoutheast_asiansouth_asiannordicwestern_europeaneastern_europeanmediterraneanafricanafrican_americanmiddle_easternlatin_americanbrazilianmixed_asian_europeanpolynesian
age Tipe: string: Age range.
Nilai: early_20slate_20searly_30slate_30s40s50sbaby_1toddler_2_4young_5_7child_8_10preteen_11_13
skin_tone Tipe: string: Skin tone.
Nilai: lightlight_mediummediummedium_darkdark
face_shape Tipe: string: Face shape.
Nilai: ovalsquareroundheartoblongdiamond
eye_color Tipe: string: Eye color.
Nilai: browndark_brownblackbluegreenhazelgrayamber
eye_shape Tipe: string: Eye shape.
Nilai: almondroundmonolidhoodedupturneddownturned
expression Tipe: string: Facial expression.
Nilai: neutralsoft_smilewarm_smileseriousconfidentfriendly
facial_hair Tipe: string: Facial hair style (Male only).
Nilai: nonelight_stubblemedium_stubbleshort_beardfull_beardgoateemustache
makeup Tipe: string: Makeup style (Female only).
Nilai: naturalminimalsoft_glamprofessionaleditorial
hair_style Tipe: string: Hair style. Available options depend on category — use /options endpoint.
hair_color Tipe: string: Hair color.
Nilai: blackdark_brownmedium_brownlight_brownauburnredblondeplatinum_blondegraywhite
hair_texture Tipe: string: Hair texture.
Nilai: straightwavycurlycoily
body_type Tipe: string: Body type. Options depend on category — use /options endpoint.
height Tipe: string: Height.
Nilai: shortaveragetall
glasses Tipe: string: Glasses.
Nilai: noneeyeglassessunglasses
freckles Tipe: string: Freckles.
Nilai: nonelightprominent
piercings Tipe: string: Piercings.
Nilai: noneearnosemultiple

Error

StatusTipeArti

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.

Batasan

600 request per menit per API key (Fixed window; batasannya sama di setiap paket)
Respons 429 menyertakan Retry-After: 30 detik
Hingga 10 MB per gambar
Format: JPEG, PNG, WebP
Batch konkuren per paket: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Hanya polling — API tidak mengirim webhook.

Atribut masuk, model yang dapat digunakan kembali keluar

Baca opsi, pilih atribut, kirim, lakukan polling, lalu gunakan kembali id-nya.

Langkah 1
Hasilkan API key
Pembuatan manekin menggunakan kredensial yang sama dan saldo credit yang sama dengan setiap kapabilitas Photta lainnya.
Langkah 2
Baca katalog opsi
GET `/api/v1/mannequins/generate/options` mengembalikan setiap nilai yang diterima, termasuk daftar `hair_style` dan `body_type` yang berbeda berdasarkan kategori. Gunakan ini untuk mengisi formulir Anda daripada melakukan hardcode pada enum.
Langkah 3
POST manekin
POST `/api/v1/mannequins/generate` dengan `category` — `Female`, `Male`, `GirlChild`, atau `BoyChild` — ditambah salah satu dari 17 atribut opsional: etnis, usia, warna kulit, bentuk wajah dan mata, ekspresi, rambut wajah, riasan, rambut, tipe tubuh, tinggi badan, kacamata, bintik-bintik wajah, dan tindik.
Langkah 4
Lakukan polling hingga pekerjaan selesai
GET `/api/v1/mannequins/generate/:id` setiap 3 detik hingga `data.status` bernilai `completed` atau `failed`; penyelesaian umumnya memakan waktu 30 hingga 60 detik.
Langkah 5
Gunakan kembali manekin
Body yang telah selesai memuat objek `mannequin` dengan id-nya sendiri. Teruskan id tersebut sebagai `mannequin_id` pada pekerjaan try-on atau kacamata berikutnya dan setiap bidikan akan mempertahankan wajah yang sama.

Endpoint yang sama di Node.js, Python, dan cURL

Pertanyaan yang diajukan developer sebelum menghasilkan model

Apa itu manekin AI?

Model hasil pembuatan yang penampilannya Anda tentukan sendiri alih-alih melalui casting. Model ini dikembalikan sebagai sebuah id, sehingga wajah, rambut, dan tubuh yang sama dapat mengenakan setiap pakaian di dalam katalog.

Berapa biaya satu manekin?

4 credits, baik untuk pembangun pakaian maupun pembangun perhiasan. Menggunakan kembali manekin yang sudah ada pada pemotretan berikutnya tidak dikenakan biaya tambahan — Anda membayar untuk try-on, bukan untuk modelnya.

Atribut apa saja yang dapat saya atur?

`category` wajib diisi. Atribut lainnya bersifat opsional: etnis, usia, warna kulit, bentuk wajah, warna dan bentuk mata, ekspresi, rambut wajah, riasan, gaya rambut, warna dan tekstur rambut, tipe tubuh, tinggi badan, kacamata, bintik-bintik wajah, dan tindik. Endpoint opsi mencantumkan nilai-nilai yang diterima.

Untuk apa pembangun perhiasan digunakan?

POST `/api/v1/mannequins/jewelry/generate` membangun model yang disesuaikan untuk foto close-up perhiasan: endpoint ini menerima `jewelry_type`, `shot_type`, `camera_angle`, `background`, dan `lighting` alih-alih atribut seluruh tubuh, sehingga garis leher, telinga, atau tangan terlihat tepat pada jarak dekat.

Dapatkah saya menggunakan kembali model yang sama di berbagai pemotretan?

Ya — itulah tujuan utama endpoint ini. Id manekin yang dihasilkan diterima sebagai `mannequin_id` oleh try-on pakaian, try-on perhiasan, dan studio kacamata.

Bagaimana cara melakukan polling untuk hasilnya?

GET `/api/v1/mannequins/generate/:id` setiap 3 detik hingga `data.status` bernilai `completed` atau `failed`. Builder perhiasan melakukan polling ke path statusnya sendiri.

Kapabilitas terkait

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa 2026-09-10

Coba API dalam lima menit

Buat Photta API key, tempel cuplikan cURL di atas, dan Anda akan mendapatkan gambar on-model pertama sebelum kopi selesai diseduh.

Buat akun dan dapatkan API key Baca dokumentasi

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

API pembuatan manekin AI untuk model Anda sendiri

Sekilas

Request dan response

Parameter request

Error

Atribut masuk, model yang dapat digunakan kembali keluar

Hasilkan API key

Baca katalog opsi

POST manekin

Lakukan polling hingga pekerjaan selesai

Gunakan kembali manekin

Endpoint yang sama di Node.js, Python, dan cURL

Pertanyaan yang diajukan developer sebelum menghasilkan model

Kapabilitas terkait

Coba API dalam lima menit