Capability · Mannequin-Generierung

KI-Mannequin-Generierungs-API für eigene Models

In aller Kürze

Die Mannequin-Generierungs-API von Photta erstellt ein fotorealistisches KI-Model aus von Ihnen ausgewählten Attributen, liefert eine wiederverwendbare Mannequin-ID zurück und kostet 4 credits. Zwei Builder: einer für Bekleidung, einer optimiert für Schmuck-Nahaufnahmen.

API-Key anfordern Dokumentation lesen

Typische Dauer: 30-60s
Credits: 4 Credits
Verarbeitung: asynchron, Polling
Limits: 600 Anfragen/Min.
Authentifizierung: Bearer-Key

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft 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"]

Auf einen Blick

Endpoint: POST /api/v1/mannequins/generate
Authentifizierung: Bearer-API-Schlüssel
Verarbeitung: Asynchron — Polling über den Status-Endpoint
Typische Dauer: 30-60s
Credits: 4 Credits
Eingabelimits: Bis zu 10 MB pro Bild; JPEG, PNG, WebP
Idempotent: Nein

Request und 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 / Abgeschlossen

{
  "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-Parameter

FeldBeschreibung

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

Fehler

StatusTypBedeutung

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.

Limits

600 Anfragen pro Minute pro API-Schlüssel (Festes Zeitfenster; das Limit ist in jedem Tarif identisch)
Ein 429 enthält Retry-After: 30 Sekunden
Bis zu 10 MB pro Bild
Formate: JPEG, PNG, WebP
Gleichzeitige Batches pro Tarif: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Nur Polling — die API sendet keine Webhooks.

Attribute rein, wiederverwendbares Model raus

Optionen abrufen, Attribute wählen, absenden, polle, dann die ID wiederverwenden.

Schritt 1
API-Key generieren
Die Mannequin-Generierung nutzt dieselben Zugangsdaten und dasselbe Credit-Guthaben wie jede andere Photta-Capability.
Schritt 2
Optionskatalog auslesen
GET `/api/v1/mannequins/generate/options` liefert jeden akzeptierten Wert zurück, einschließlich der Listen für `hair_style` und `body_type`, die sich je nach Kategorie unterscheiden. Steuern Sie Ihr Formular darüber, statt die Enums fest einzucodieren.
Schritt 3
Mannequin per POST anlegen
POST `/api/v1/mannequins/generate` mit `category` — `Female`, `Male`, `GirlChild` oder `BoyChild` — plus beliebigen der 17 optionalen Attribute: Ethnie, Alter, Hautton, Gesichts- und Augenform, Mimik, Bart, Make-up, Haare, Körpertyp, Körpergröße, Brille, Sommersprossen und Piercings.
Schritt 4
Pollen, bis der Job abgeschlossen ist
GET `/api/v1/mannequins/generate/:id` alle 3 Sekunden ausführen, bis `data.status` `completed` oder `failed` ist; die typische Ausführungszeit liegt bei 30 bis 60 Sekunden.
Schritt 5
Mannequin wiederverwenden
Der fertige Body enthält ein `mannequin`-Objekt mit einer eigenen ID. Übergeben Sie diese ID bei späteren Try-on- oder Brillen-Jobs als `mannequin_id`, damit jeder Shot dasselbe Gesicht behält.

Derselbe Endpoint in Node.js, Python und cURL

Fragen, die Entwickler vor der Modellgenerierung stellen

Was ist ein KI-Mannequin?

Ein generiertes Model, dessen Erscheinungsbild Sie über Parameter definieren, anstatt es zu casten. Es wird als ID zurückgegeben, sodass dasselbe Gesicht, dieselben Haare und derselbe Körper jedes Kleidungsstück eines Katalogs tragen können.

Wie viel kostet ein Mannequin?

4 credits, sowohl für den Apparel-Builder als auch für den Jewelry-Builder. Das Wiederverwenden eines bestehenden Mannequins in einem späteren Shooting kostet nichts extra — Sie zahlen für das Try-on, nicht für das Model.

Welche Attribute kann ich festlegen?

`category` ist erforderlich. Alles andere ist optional: Ethnie, Alter, Hautton, Gesichtsform, Augenfarbe und -form, Mimik, Bart, Make-up, Frisur, Haarfarbe und -struktur, Körpertyp, Körpergröße, Brille, Sommersprossen und Piercings. Der options-Endpoint listet die zulässigen Werte auf.

Wozu dient der Jewelry-Builder?

POST `/api/v1/mannequins/jewelry/generate` erstellt ein Model, das speziell für Schmuck-Nahaufnahmen optimiert ist: Es akzeptiert `jewelry_type`, `shot_type`, `camera_angle`, `background` und `lighting` anstelle von Ganzkörperattributen, damit Halslinie, Ohr oder Hand aus nächster Nähe korrekt dargestellt werden.

Kann ich dasselbe Model über mehrere Shootings hinweg wiederverwenden?

Ja — genau das ist der Zweck des Endpoints. Die generierte Mannequin-ID wird von Apparel-Try-on, Jewelry-Try-on und dem Brillen-Studio als `mannequin_id` akzeptiert.

Wie führe ich das Polling für das Ergebnis durch?

GET `/api/v1/mannequins/generate/:id` alle 3 Sekunden aufrufen, bis `data.status` auf `completed` oder `failed` steht. Der Jewelry-Builder pollt seinen eigenen Status-Pfad.

Testen Sie die API in fünf Minuten

Generieren Sie einen Photta-API-Schlüssel, fügen Sie das obige cURL-Snippet ein, und Sie erhalten Ihr erstes Bild am Model, noch bevor der Kaffee fertig gebrüht ist.

Konto erstellen und API-Key anfordern Dokumentation lesen

30-60s
4 Credits
asynchron, Polling
600 Anfragen/Min.
Bearer-Key

KI-Mannequin-Generierungs-API für eigene Models

Auf einen Blick

Request und Response

Request-Parameter

Fehler

Attribute rein, wiederverwendbares Model raus

API-Key generieren

Optionskatalog auslesen

Mannequin per POST anlegen

Pollen, bis der Job abgeschlossen ist

Mannequin wiederverwenden

Derselbe Endpoint in Node.js, Python und cURL

Fragen, die Entwickler vor der Modellgenerierung stellen

Verwandte Capabilities

Testen Sie die API in fünf Minuten