Yetenek · Manken üretimi

Yapay zeka manken üretimi API'si kendi modelleriniz için

Tek cümlede

Photta’nın manken üretim API'si, seçtiğiniz özniteliklerden fotogerçekçi bir yapay zeka modeli oluşturur, yeniden kullanılabilir bir manken kimliği döndürür ve maliyeti 4 credits'tir. İki oluşturucu mevcuttur: biri giyim için, diğeri takı yakın çekimleri için optimize edilmiştir.

API anahtarı alın Dokümantasyonu okuyun

Tipik süre: 30-60s
Credits: 4 credits
İşleme: asenkron, polling
Sınırlar: 600 istek/dk
Kimlik doğrulama: Bearer anahtarı

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi 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"]

Genel bakış

Endpoint: POST /api/v1/mannequins/generate
Kimlik doğrulama: Bearer API anahtarı
İşleme: Asenkron — durum endpoint'ini sorgulayın (poll)
Tipik süre: 30-60s
Credits: 4 credits
Girdi sınırları: Görsel başına en fazla 10 MB; JPEG, PNG, WebP
Idempotent: Hayır

İstek ve yanıt

İstek

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

İstek parametreleri

AlanAçıklama

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

Hatalar

DurumTürAnlam

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.

Sınırlar

API anahtarı başına dakikada 600 istek (Sabit pencere; limit her planda aynıdır)
429 yanıtı Retry-After: 30 saniye içerir
Görsel başına en fazla 10 MB
Formatlar: JPEG, PNG, WebP
Plan başına eşzamanlı toplu işlem: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Yalnızca polling — API webhook göndermez.

Öznitelikler girer, yeniden kullanılabilir bir model çıkar

Seçenekleri okuyun, öznitelikleri belirleyin, gönderin, poll edin, ardından kimliği yeniden kullanın.

Adım 1
Bir API anahtarı oluşturun
Manken üretimi, diğer tüm Photta yetenekleriyle aynı kimlik bilgilerini ve aynı kredi bakiyesini kullanır.
Adım 2
Seçenekler kataloğunu okuyun
GET `/api/v1/mannequins/generate/options`, kategoriye göre farklılık gösteren `hair_style` ve `body_type` listeleri de dahil olmak üzere kabul edilen tüm değerleri döndürür. Enum değerlerini hardcode etmek yerine formunuzu buradan besleyin.
Adım 3
Mankeni POST edin
`category` — `Female`, `Male`, `GirlChild` veya `BoyChild` — ve 17 isteğe bağlı öznitelikten herhangi biriyle POST `/api/v1/mannequins/generate` isteği atın: etnik köken, yaş, cilt tonu, yüz ve göz yapısı, ifade, sakal-bıyık, makyaj, saç, vücut tipi, boy, gözlük, çil ve piercing.
Adım 4
İş tamamlanana kadar poll edin
`data.status` değeri `completed` veya `failed` olana kadar her 3 saniyede bir GET `/api/v1/mannequins/generate/:id` isteği atın; tipik tamamlanma süresi 30 ila 60 saniyedir.
Adım 5
Mankeni yeniden kullanın
Tamamlanan gövde, kendi kimliğine sahip bir `mannequin` nesnesi taşır. Bu kimliği sonraki try-on veya gözlük işlerinde `mannequin_id` olarak ilettiğinizde her karede aynı yüz korunur.

Node.js, Python ve cURL'de aynı endpoint

Geliştiricilerin model üretmeden önce sorduğu sorular

Yapay zeka mankeni nedir?

Cast seçimi yapmak yerine görünümünü sizin belirlediğiniz, üretilmiş bir modeldir. Bir kimlik olarak döndürülür; böylece aynı yüz, saç ve vücut, bir katalogdaki her giysiyi taşıyabilir.

Bir mankenin maliyeti nedir?

Hem giyim oluşturucu hem de takı oluşturucu için 4 credits. Mevcut bir mankeni sonraki bir çekimde yeniden kullanmak ek bir ücrete tabi değildir — model için değil, try-on için ödeme yaparsınız.

Hangi öznitelikleri ayarlayabilirim?

`category` zorunludur. Diğer her şey isteğe bağlıdır: etnik köken, yaş, cilt tonu, yüz yapısı, göz rengi ve yapısı, ifade, sakal-bıyık, makyaj, saç stili, rengi ve dokusu, vücut tipi, boy, gözlük, çil ve piercing. options endpoint'i kabul edilen değerleri listeler.

Takı oluşturucu ne işe yarar?

POST `/api/v1/mannequins/jewelry/generate`, yakın plan takı çalışmaları için optimize edilmiş bir model oluşturur: tam vücut öznitelikleri yerine `jewelry_type`, `shot_type`, `camera_angle`, `background` ve `lighting` alır; böylece dekolte, kulak veya el yakın mesafeden kusursuz görünür.

Aynı modeli farklı çekimlerde yeniden kullanabilir miyim?

Evet — endpoint'in asıl amacı budur. Üretilen manken kimliği; giyim try-on, takı try-on ve gözlük stüdyosu tarafından `mannequin_id` olarak kabul edilir.

Sonuç için nasıl polling yaparım?

`data.status` değeri `completed` veya `failed` olana kadar her 3 saniyede bir GET `/api/v1/mannequins/generate/:id` çağrısı yapın. Takı oluşturucu kendi durum yolunu poll eder.

İlgili yetenekler

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi 2026-09-10

API'yi beş dakikada deneyin

Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.

Bir hesap oluşturun ve API anahtarı alın Dokümantasyonu okuyun

30-60s
4 credits
asenkron, polling
600 istek/dk
Bearer anahtarı

Yapay zeka manken üretimi API'si kendi modelleriniz için

Genel bakış

İstek ve yanıt

İstek parametreleri

Hatalar

Öznitelikler girer, yeniden kullanılabilir bir model çıkar

Bir API anahtarı oluşturun

Seçenekler kataloğunu okuyun

Mankeni POST edin

İş tamamlanana kadar poll edin

Mankeni yeniden kullanın

Node.js, Python ve cURL'de aynı endpoint

Geliştiricilerin model üretmeden önce sorduğu sorular

İlgili yetenekler

API'yi beş dakikada deneyin