Funktion · Mannequingenerering

API til AI-mannequingenerering til dine egne modeller

I én sætning

Phottas API til mannequingenerering bygger en fotorealistisk AI-model ud fra attributter, du vælger, returnerer et genanvendeligt mannequin-id og koster 4 credits. To builders: én til tøj, én optimeret til nærbilleder af smykker.

Hent en API-nøgle Læs dokumentationen

Typisk tid: 30-60s
Credits: 4 credits
Behandling: async, polling
Grænser: 600 requests/min
Autentifikation: Bearer key

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket 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 fortalt

Endpoint: POST /api/v1/mannequins/generate
Autentifikation: Bearer API-nøgle
Behandling: Asynkron — poll status-endpointet
Typisk tid: 30-60s
Credits: 4 credits
Inputgrænser: Op til 10 MB pr. billede; JPEG, PNG, WebP
Idempotent: Nej

Request og 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-parametre

FeltBeskrivelse

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

Fejl

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.

Grænser

600 anmodninger i minuttet pr. API-nøgle (Fast vindue; grænsen er den samme på alle planer)
En 429 indeholder Retry-After: 30 sekunder
Op til 10 MB pr. billede
Formater: JPEG, PNG, WebP
Samtidige batches pr. plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Kun polling — API'et sender ingen webhooks.

Attributter ind, en genanvendelig model ud

Læs valgmulighederne, vælg attributter, indsend, poll, og genbrug derefter id'et.

Trin 1
Generér en API-nøgle
Mannequingenerering bruger de samme legitimationsoplysninger og den samme credit-saldo som alle andre Photta-funktioner.
Trin 2
Læs options-kataloget
GET `/api/v1/mannequins/generate/options` returnerer alle accepterede værdier, herunder listerne over `hair_style` og `body_type`, som varierer efter kategori. Styr din formular ud fra dette frem for at hardkode dine enums.
Trin 3
POST mannequinen
POST `/api/v1/mannequins/generate` med `category` — `Female`, `Male`, `GirlChild` eller `BoyChild` — plus enhver af de 17 valgfrie attributter: etnicitet, alder, hudtone, ansigts- og øjenform, udtryk, ansigtshår, makeup, hår, kropstype, højde, briller, fregner og piercinger.
Trin 4
Poll, indtil opgaven er fuldført
GET `/api/v1/mannequins/generate/:id` hvert 3. sekund, indtil `data.status` er `completed` eller `failed`; fuldførelse tager typisk 30 til 60 sekunder.
Trin 5
Genbrug mannequinen
Den fuldførte krop indeholder et `mannequin`-objekt med sit eget id. Send dette id som `mannequin_id` på senere try-on- eller brille-jobs, og hvert billede bevarer det samme ansigt.

Det samme endpoint i Node.js, Python og cURL

Spørgsmål, udviklere stiller, før de genererer modeller

Hvad er en AI-mannequin?

En genereret model, hvis udseende du definerer frem for at caste. Den returneres som et id, så det samme ansigt, hår og krop kan bære alle beklædningsgenstande i et katalog.

Hvor meget koster en mannequin?

4 credits, både for apparel-builderen og jewelry-builderen. Genbrug af en eksisterende mannequin i et senere shoot koster ikke ekstra — du betaler for try-on, ikke for modellen.

Hvilke attributter kan jeg angive?

`category` er påkrævet. Alt andet er valgfrit: etnicitet, alder, hudtone, ansigtsform, øjenfarve og -form, udtryk, ansigtshår, makeup, frisure, hårfarve og -struktur, kropstype, højde, briller, fregner og piercinger. Options-endpointet oplister de accepterede værdier.

Hvad bruges jewelry-builderen til?

POST `/api/v1/mannequins/jewelry/generate` bygger en model optimeret til nærbilleder af smykker: den tager `jewelry_type`, `shot_type`, `camera_angle`, `background` og `lighting` i stedet for fuldkropsattributterne, så halsudskæring, øre eller hånd gengives korrekt på tæt hold.

Kan jeg genbruge den samme model på tværs af shoots?

Ja — det er hele formålet med endpointet. Det genererede mannequin-id accepteres som `mannequin_id` af try-on til tøj, try-on til smykker og brille-studiet.

Hvordan poller jeg for resultatet?

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

Relaterede funktioner

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket 2026-09-10

Prøv API'et på fem minutter

Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.

Opret en konto og hent en API-nøgle Læs dokumentationen

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

API til AI-mannequingenerering til dine egne modeller

Kort fortalt

Request og response

Request-parametre

Fejl

Attributter ind, en genanvendelig model ud

Generér en API-nøgle

Læs options-kataloget

POST mannequinen

Poll, indtil opgaven er fuldført

Genbrug mannequinen

Det samme endpoint i Node.js, Python og cURL

Spørgsmål, udviklere stiller, før de genererer modeller

Relaterede funktioner

Prøv API'et på fem minutter