Functionaliteit · Mannequin-generatie

AI mannequin-generatie API voor je eigen modellen

In één zin

Photta’s mannequin-generatie API bouwt een fotorealistisch AI-model op basis van attributen die je kiest, retourneert een herbruikbare mannequin-id en kost 4 credits. Twee builders: één voor kleding, één afgestemd op close-ups van sieraden.

API-sleutel ophalen Lees de documentatie

Typische duur: 30-60s
Credits: 4 credits
Verwerking: async, polling
Limieten: 600 requests/min
Authenticatie: Bearer key

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 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"]

In één oogopslag

Endpoint: POST /api/v1/mannequins/generate
Authenticatie: Bearer API key
Verwerking: Asynchroon — poll het status-endpoint
Typische duur: 30-60s
Credits: 4 credits
Invoerlimieten: Tot 10 MB per afbeelding; JPEG, PNG, WebP
Idempotent: Nee

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

Request-parameters

VeldBeschrijving

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

Errors

StatusTypeBetekenis

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.

Limieten

600 verzoeken per minuut per API key (Vast venster; de limiet is identiek op elk abonnement)
Een 429 bevat Retry-After: 30 seconden
Tot 10 MB per afbeelding
Formaten: JPEG, PNG, WebP
Gelijktijdige batches per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Uitsluitend polling — de API stuurt geen webhooks.

Attributen erin, een herbruikbaar model eruit

Lees de opties, kies attributen, verzend, poll en hergebruik vervolgens het id.

Stap 1
Genereer een API-key
Mannequin-generatie gebruikt dezelfde inloggegevens en hetzelfde creditsaldo als elke andere Photta-functionaliteit.
Stap 2
Lees de optiecatalogus
GET `/api/v1/mannequins/generate/options` retourneert elke geaccepteerde waarde, inclusief de lijsten voor `hair_style` en `body_type` die per categorie verschillen. Stuur je formulier hiermee aan in plaats van de enums te hardcoderen.
Stap 3
POST de mannequin
POST `/api/v1/mannequins/generate` met `category` — `Female`, `Male`, `GirlChild` of `BoyChild` — plus een van de 17 optionele attributen: etniciteit, leeftijd, huidskleur, gezichts- en oogvorm, expressie, gezichtsbeharing, make-up, haar, lichaamstype, lengte, bril, sproeten en piercings.
Stap 4
Poll totdat de taak is voltooid
GET `/api/v1/mannequins/generate/:id` elke 3 seconden totdat `data.status` `completed` of `failed` is; gebruikelijke verwerkingstijd is 30 tot 60 seconden.
Stap 5
Hergebruik de mannequin
De voltooide body bevat een `mannequin`-object met een eigen id. Geef dat id mee als `mannequin_id` bij latere try-on- of eyewear-taken en elk beeld behoudt hetzelfde gezicht.

Hetzelfde endpoint in Node.js, Python en cURL

Vragen die developers stellen voor het genereren van modellen

Wat is een AI-mannequin?

Een gegenereerd model waarvan je het uiterlijk specificeert in plaats van te casten. Het wordt geretourneerd als een id, zodat hetzelfde gezicht, haar en lichaam elk kledingstuk in een catalogus kan dragen.

Hoeveel kost een mannequin?

4 credits, voor zowel de kleding-builder als de sieraden-builder. Het hergebruiken van een bestaande mannequin in een latere shoot kost niets extra — je betaalt voor de try-on, niet voor het model.

Welke attributen kan ik instellen?

`category` is verplicht. Al het andere is optioneel: etniciteit, leeftijd, huidskleur, gezichtsvorm, oogkleur en -vorm, expressie, gezichtsbeharing, make-up, haarstijl, kleur en textuur, lichaamstype, lengte, bril, sproeten en piercings. Het options-endpoint vermeldt de geaccepteerde waarden.

Waar dient de sieraden-builder voor?

POST `/api/v1/mannequins/jewelry/generate` bouwt een model dat is afgestemd op close-up sieradenwerk: het accepteert `jewelry_type`, `shot_type`, `camera_angle`, `background` en `lighting` in plaats van de full-body-attributen, zodat de halslijn, het oor of de hand van dichtbij correct overkomt.

Kan ik hetzelfde model hergebruiken in meerdere shoots?

Ja — dat is het hele doel van het endpoint. Het gegenereerde mannequin-id wordt geaccepteerd als `mannequin_id` door kleding-try-on, sieraden-try-on en de eyewear-studio.

Hoe poll ik voor het resultaat?

GET `/api/v1/mannequins/generate/:id` elke 3 seconden totdat `data.status` `completed` of `failed` is. De jewelry builder pollt zijn eigen statuspad.

Gerelateerde functionaliteiten

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Probeer de API in vijf minuten

Genereer een Photta API-sleutel, plak het bovenstaande cURL-fragment en je hebt je eerste afbeelding op een model voordat de koffie klaar is.

Maak een account aan en haal een API-sleutel op Lees de documentatie

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

AI mannequin-generatie API voor je eigen modellen

In één oogopslag

Request en response

Request-parameters

Errors

Attributen erin, een herbruikbaar model eruit

Genereer een API-key

Lees de optiecatalogus

POST de mannequin

Poll totdat de taak is voltooid

Hergebruik de mannequin

Hetzelfde endpoint in Node.js, Python en cURL

Vragen die developers stellen voor het genereren van modellen

Gerelateerde functionaliteiten

Probeer de API in vijf minuten