Ominaisuus · Mannekiinien generointi

Tekoälymannekiinien generointi-API omille malleillesi

Yhdellä lauseella

Phottan mannekiinien generointi-API rakentaa fotorealistisen tekoälymallin valitsemiesi attribuuttien perusteella, palauttaa uudelleenkäytettävän mannequin id:n ja maksaa 4 credits. Kaksi työkalua: toinen vaatteille ja toinen optimoitu korujen lähikuviin.

Hanki API-avain Lue dokumentaatio

Tyypillinen kesto: 30-60s
Credits: 4 credits
Käsittely: asynkroninen, polling
Rajoitukset: 600 pyyntöä/min
Autentikointi: Bearer-avain

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 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"]

Lyhyesti

Endpoint: POST /api/v1/mannequins/generate
Autentikointi: Bearer-API-avain
Käsittely: Asynkroninen — tee polling-kyselyitä status-endpointiin
Tyypillinen kesto: 30-60s
Credits: 4 credits
Syöterajoitukset: Enintään 10 MB per kuva; JPEG, PNG, WebP
Idempotentti: Ei

Pyyntö ja vastaus

Pyyntö

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

Pyyntöparametrit

KenttäKuvaus

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

Virheet

TilaTyyppiMerkitys

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.

Rajoitukset

600 pyyntöä minuutissa per API-avain (Kiinteä aikaikkuna; rajoitus on sama kaikissa tilauksissa)
Vastaus 429 sisältää otsakkeen Retry-After: 30 sekuntia
Enintään 10 MB per kuva
Formaatit: JPEG, PNG, WebP
Rinnakkaiset eräajot per tilaus: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Vain polling — API ei lähetä webhookeja.

Attribuutit sisään, uudelleenkäytettävä malli ulos

Lue vaihtoehdot, valitse attribuutit, lähetä pyyntö, käytä pollingia ja hyödynnä id:tä uudelleen.

Vaihe 1
Generoi API-avain
Mannekiinien generointi käyttää samoja tunnistautumistietoja ja samaa credits-saldoa kuin kaikki muutkin Phottan toiminnot.
Vaihe 2
Lue vaihtoehtoluettelo
GET `/api/v1/mannequins/generate/options` palauttaa kaikki hyväksytyt arvot, mukaan lukien `hair_style`- ja `body_type` -listat, jotka vaihtelevat kategorioittain. Rakenna lomakkeesi sen pohjalta enumin kovakoodaamisen sijaan.
Vaihe 3
Luo mannekiini POST-pyynnöllä
Tee POST-kutsu osoitteeseen `/api/v1/mannequins/generate` käyttäen parametria `category` — `Female`, `Male`, `GirlChild` tai `BoyChild` — sekä mitä tahansa 17 valinnaisesta attribuutista: etnisyys, ikä, ihon sävy, kasvojen ja silmien muoto, ilme, parta, meikki, hiukset, vartalotyyppi, pituus, silmälasit, pisamat ja lävistykset.
Vaihe 4
Käytä pollingia, kunnes työ on valmis
Tee GET-kutsu osoitteeseen `/api/v1/mannequins/generate/:id` 3 sekunnin välein, kunnes `data.status` on `completed` tai `failed`; tyypillinen valmistumisaika on 30–60 sekuntia.
Vaihe 5
Käytä mannekiinia uudelleen
Valmistunut runko sisältää `mannequin`-objektin omalla id:llään. Välitä kyseinen id parametrina `mannequin_id` myöhemmissä try-on- tai silmälasitöissä, jolloin jokaisessa kuvassa säilyvät samat kasvot.

Sama endpoint kielillä Node.js, Python ja cURL

Kehittäjien usein kysymät kysymykset ennen mallien generointia

Mikä on tekoälymannekiini?

Generoitu malli, jonka ulkonäön määrität roolituksen sijaan. Se palautetaan id-tunnisteena, joten samat kasvot, hiukset ja vartalo voivat kantaa luettelon jokaista vaatetta.

Paljonko mannekiini maksaa?

4 credits sekä vaatetyökalussa että korutyökalussa. Olemassa olevan mannekiinin uudelleenkäyttö myöhemmissä kuvauksissa ei maksa mitään ylimääräistä — maksat try-on-toiminnosta, et mallista.

Mitä attribuutteja voin määrittää?

`category` on pakollinen. Kaikki muu on valinnaista: etnisyys, ikä, ihon sävy, kasvojen muoto, silmien väri ja muoto, ilme, parta, meikki, hiustyyli, väri ja rakenne, vartalotyyppi, pituus, silmälasit, pisamat ja lävistykset. Valintavaihtoehtojen endpoint listaa hyväksytyt arvot.

Mihin korutyökalu on tarkoitettu?

POST `/api/v1/mannequins/jewelry/generate` rakentaa mallin, joka on optimoitu korujen lähikuviin: se ottaa vastaan parametrit `jewelry_type`, `shot_type`, `camera_angle`, `background` ja `lighting` kokovartaloattribuuttien sijaan, jotta kaula-aukko, korva tai käsi toistuu oikein lähietäisyydeltä.

Voinko käyttää samaa mallia uudelleen eri kuvauksissa?

Kyllä — se on koko endpointin tarkoitus. Generoitu mannekiini-id hyväksytään parametrina `mannequin_id` vaatteiden try-onissa, korujen try-onissa sekä silmälasistudiossa.

Miten kyselen tulosta (polling)?

Tee GET `/api/v1/mannequins/generate/:id` 3 sekunnin välein, kunnes `data.status` on `completed` tai `failed`. Korujen luontitoiminto käyttää omaa tilapolkuaan.

Liittyvät toiminnot

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 2026-09-10

Kokeile APIa viidessä minuutissa

Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.

Luo tili ja hanki API-avain Lue dokumentaatio

30-60s
4 credits
asynkroninen, polling
600 pyyntöä/min
Bearer-avain

Tekoälymannekiinien generointi-API omille malleillesi

Lyhyesti

Pyyntö ja vastaus

Pyyntöparametrit

Virheet

Attribuutit sisään, uudelleenkäytettävä malli ulos

Generoi API-avain

Lue vaihtoehtoluettelo

Luo mannekiini POST-pyynnöllä

Käytä pollingia, kunnes työ on valmis

Käytä mannekiinia uudelleen

Sama endpoint kielillä Node.js, Python ja cURL

Kehittäjien usein kysymät kysymykset ennen mallien generointia

Liittyvät toiminnot

Kokeile APIa viidessä minuutissa