Funksjonalitet · Mannekenggenerering

API for AI-mannekenggenerering for dine egne modeller

I én setning

Phottas API for mannekenggenerering bygger en fotorealistisk AI-modell fra attributter du velger, returnerer en gjenbrukbar mannekeng-id og koster 4 credits. To byggere: én for klær, én optimalisert for nærbilder av smykker.

Få en API-nøkkel Les dokumentasjonen

Typisk tidsbruk: 30-60s
Credits: 4 credits
Prosessering: asynkron, polling
Grenser: 600 forespørsler/min
Autentisering: Bearer-nøkkel

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 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"]

Kort oppsummert

Endepunkt: POST /api/v1/mannequins/generate
Autentisering: Bearer API-nøkkel
Prosessering: Asynkron – poll status-endepunktet
Typisk tidsbruk: 30-60s
Credits: 4 credits
Inndatagrenser: Opptil 10 MB per bilde; JPEG, PNG, WebP
Idempotent: Nei

Forespørsel og respons

Forespørsel

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

Forespørselsparametere

FeltBeskrivelse

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

Feil

StatusTypeBetydning

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.

Grenser

600 forespørsler per minutt per API-nøkkel (Fast tidsvindu; grensen er lik for alle abonnementer)
En 429 inneholder Retry-After: 30 sekunder
Opptil 10 MB per bilde
Formater: JPEG, PNG, WebP
Samtidige batcher per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Kun polling – API-et sender ikke webhooks.

Attributter inn, en gjenbrukbar modell ut

Les alternativer, velg attributter, send inn, poll, og gjenbruk deretter id-en.

Trinn 1
Generer en API-nøkkel
Mannekenggenerering bruker samme autentisering og samme credit-saldo som all annen Photta-funksjonalitet.
Trinn 2
Les options-katalogen
GET `/api/v1/mannequins/generate/options` returnerer alle gyldige verdier, inkludert listene for `hair_style` og `body_type` som varierer etter kategori. Bygg skjemaet ditt basert på dette i stedet for å hardkode enum-verdiene.
Trinn 3
POST mannekengen
POST `/api/v1/mannequins/generate` med `category` — `Female`, `Male`, `GirlChild` eller `BoyChild` — pluss hvilke som helst av de 17 valgfrie attributtene: etnisitet, alder, hudtone, ansikts- og øyeform, uttrykk, ansiktshår, sminke, hår, kroppstype, høyde, briller, fregner og piercinger.
Trinn 4
Poll til jobben er fullført
GET `/api/v1/mannequins/generate/:id` hvert 3. sekund til `data.status` er `completed` eller `failed`; fullføres vanligvis på 30 til 60 sekunder.
Trinn 5
Gjenbruk mannekengen
Den fullførte responsen inneholder et `mannequin`-objekt med en egen id. Send denne id-en som `mannequin_id` i senere try-on- eller brille-jobber, så beholder hvert bilde det samme ansiktet.

Det samme endepunktet i Node.js, Python og cURL

Spørsmål utviklere stiller før de genererer modeller

Hva er en AI-mannekeng?

En generert modell der du spesifiserer utseendet i stedet for å caste. Den returneres som en id, slik at samme ansikt, hår og kropp kan bære alle plaggene i en katalog.

Hvor mye koster en mannekeng?

4 credits, for både klesbyggeren og smykkebyggeren. Gjenbruk av en eksisterende mannekeng i et senere opptak koster ingenting ekstra — du betaler for try-on, ikke for modellen.

Hvilke attributter kan jeg angi?

`category` er obligatorisk. Alt annet er valgfritt: etnisitet, alder, hudtone, ansiktsform, øyefarge og -form, uttrykk, ansiktshår, sminke, frisyre, farge og tekstur, kroppstype, høyde, briller, fregner og piercinger. Options-endepunktet lister opp alle gyldige verdier.

Hva brukes smykkebyggeren til?

POST `/api/v1/mannequins/jewelry/generate` bygger en modell tilpasset nærbilder av smykker: den tar `jewelry_type`, `shot_type`, `camera_angle`, `background` og `lighting` i stedet for helkroppsattributtene, slik at halslinjen, øret eller hånden gjengis korrekt på kloss hold.

Kan jeg gjenbruke samme modell på tvers av opptak?

Ja — det er hele poenget med endepunktet. Den genererte mannekeng-id-en godtas som `mannequin_id` av try-on for klær, try-on for smykker og brillestudioet.

Hvordan poller jeg etter resultatet?

GET `/api/v1/mannequins/generate/:id` hvert 3. sekund til `data.status` er `completed` eller `failed`. Smykkebyggeren poller sin egen statussti.

Relatert funksjonalitet

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 2026-09-10

Prøv API-et på fem minutter

Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.

Opprett en konto og få en API-nøkkel Les dokumentasjonen

30-60s
4 credits
asynkron, polling
600 forespørsler/min
Bearer-nøkkel

API for AI-mannekenggenerering for dine egne modeller

Kort oppsummert

Forespørsel og respons

Forespørselsparametere

Feil

Attributter inn, en gjenbrukbar modell ut

Generer en API-nøkkel

Les options-katalogen

POST mannekengen

Poll til jobben er fullført

Gjenbruk mannekengen

Det samme endepunktet i Node.js, Python og cURL

Spørsmål utviklere stiller før de genererer modeller

Relatert funksjonalitet

Prøv API-et på fem minutter