Förmåga · Mannekänggenerering

API för generering av AI-mannekänger för dina egna modeller

I en mening

Phottas API för mannekänggenerering bygger en fotorealistisk AI-modell utifrån attribut du väljer, returnerar ett återanvändbart mannekäng-id och kostar 4 credits. Två byggare: en för kläder, en anpassad för närbilder på smycken.

Hämta en API-nyckel Läs dokumentationen

Typisk tid: 30-60s
Credits: 4 credits
Bearbetning: asynkron, polling
Gränser: 600 requests/min
Autentisering: Bearer-nyckel

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad 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"]

I korthet

Endpoint: POST /api/v1/mannequins/generate
Autentisering: Bearer API-nyckel
Bearbetning: Asynkron — polla status-endpointen
Typisk tid: 30-60s
Credits: 4 credits
Indatagränser: Upp till 10 MB per bild; JPEG, PNG, WebP
Idempotent: Nej

Request och 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-parametrar

FältBeskrivning

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

Fel

StatusTypBetydelse

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.

Gränser

600 anrop per minut per API-nyckel (Fast fönster; gränsen är densamma på alla planer)
En 429 innehåller Retry-After: 30 sekunder
Upp till 10 MB per bild
Format: JPEG, PNG, WebP
Samtidiga batcher per plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Endast polling — API:et skickar inga webhooks.

Attribut in, en återanvändbar modell ut

Läs alternativen, välj attribut, skicka, polla och återanvänd sedan id:t.

Steg 1
Generera en API-nyckel
Mannekänggenerering använder samma autentiseringsuppgifter och samma credits-saldo som alla andra förmågor i Photta.
Steg 2
Läs options-katalogen
GET `/api/v1/mannequins/generate/options` returnerar alla tillåtna värden, inklusive listorna för `hair_style` och `body_type` som skiljer sig per kategori. Styr ditt formulär utifrån detta istället för att hårdkoda dina enums.
Steg 3
Gör POST för mannekängen
Gör POST mot `/api/v1/mannequins/generate` med `category` — `Female`, `Male`, `GirlChild` eller `BoyChild` — plus vilket som helst av de 17 valfria attributen: etnicitet, ålder, hudton, ansikts- och ögonform, uttryck, ansiktsbehåring, smink, hår, kroppstyp, längd, glasögon, fräknar och piercingar.
Steg 4
Polla tills jobbet slutförs
Gör GET mot `/api/v1/mannequins/generate/:id` var 3:e sekund tills `data.status` är `completed` eller `failed`; typisk slutförandetid är 30 till 60 sekunder.
Steg 5
Återanvänd mannekängen
Den färdiga kroppen innehåller ett `mannequin`-objekt med ett eget id. Skicka det id:t som `mannequin_id` i senare try-on- eller glasögonjobb så behåller varje bild samma ansikte.

Samma endpoint i Node.js, Python och cURL

Frågor utvecklare ställer innan de genererar modeller

Vad är en AI-mannekäng?

En genererad modell vars utseende du specificerar i stället för att casta. Den returneras som ett id, så att samma ansikte, hår och kropp kan bära varje plagg i en katalog.

Hur mycket kostar en mannekäng?

4 credits, för både klädbyggaren och smyckesbyggaren. Att återanvända en befintlig mannekäng i en senare fotografering kostar inget extra — du betalar för try-on, inte för modellen.

Vilka attribut kan jag ställa in?

`category` krävs. Allt annat är valfritt: etnicitet, ålder, hudton, ansiktsform, ögonfärg och ögonform, uttryck, ansiktsbehåring, smink, frisyr, färg och textur, kroppstyp, längd, glasögon, fräknar och piercingar. Options-endpointen listar de tillåtna värdena.

Vad används smyckesbyggaren till?

POST `/api/v1/mannequins/jewelry/generate` bygger en modell optimerad för närbilder på smycken: den tar `jewelry_type`, `shot_type`, `camera_angle`, `background` och `lighting` i stället för helkroppsattributen, så att halsringning, öra eller hand återges korrekt på nära håll.

Kan jag återanvända samma modell i flera fotograferingar?

Ja — det är hela poängen med endpointen. Det genererade mannekäng-id:t accepteras som `mannequin_id` vid try-on för kläder, try-on för smycken och i glasögonstudion.

Hur pollar jag efter resultatet?

Gör GET mot `/api/v1/mannequins/generate/:id` var 3:e sekund tills `data.status` är `completed` eller `failed`. Smyckesbyggaren pollar sin egen statussökväg.

Relaterade förmågor

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad 2026-09-10

Testa API:et på fem minuter

Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.

Skapa ett konto och hämta en API-nyckel Läs dokumentationen

30-60s
4 credits
asynkron, polling
600 requests/min
Bearer-nyckel

API för generering av AI-mannekänger för dina egna modeller

I korthet

Request och response

Request-parametrar

Fel

Attribut in, en återanvändbar modell ut

Generera en API-nyckel

Läs options-katalogen

Gör POST för mannekängen

Polla tills jobbet slutförs

Återanvänd mannekängen

Samma endpoint i Node.js, Python och cURL

Frågor utvecklare ställer innan de genererar modeller

Relaterade förmågor

Testa API:et på fem minuter