Beş dakikadan kısa sürede ilk Photta görseli.

1. 1

   Adım 1

   Bir API anahtarı oluşturun

   ai.photta.app adresinden kaydolun ve Developers panelini açın. Generate API key seçeneğine tıklayın — canlı anahtarlar photta_live_ ile başlar. Eğitimin geri kalanının bunu kabuğunuzdan okuyabilmesi için export edin.

   cURL

   Kopyala

   # https://ai.photta.app → Developers → Generate API key
   export PHOTTA_API_KEY="photta_live_xxxxx"
   export PHOTTA_BASE_URL="https://api.photta.app/api/v1"

2. 2

   Adım 2

   İlk try-on isteğinizi POST edin

   Bir ürün görseli URL'si ve bir mannequin ID ile /api/v1/tryon/apparel endpoint'ine istek atın. API hemen 202 Accepted yanıtı verir ve data.id içinde bir üretim ID'si döndürür.

   cURL

   Kopyala

   RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
     -H "Authorization: Bearer $PHOTTA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "product_type": "top",
     "product_images": [
       "https://cdn.yourstore.com/products/shirt-front.jpg"
     ],
     "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
     "product_category": "t_shirt",
     "mannequin_id": "mnk_f3a9b1",
     "pose_id": "pose_c2d4e5",
     "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
     "lock_background": true,
     "resolution": "2K",
     "aspect_ratio": "3:4",
     "body_size": "M",
     "expression": "neutral",
     "user_instruction": "Keep the collar pattern crisp and centered."
   }')
   ID=$(echo "$RESPONSE" | jq -r '.data.id')

3. 3

   Adım 3

   Tamamlanana kadar yoklayın (poll)

   Her 3 saniyede bir GET /api/v1/tryon/apparel/:id isteği atın. Tipik tamamlanma süresi 1.5–4 dakikadır. Takılan bir işin betiğinizi sonsuza kadar askıda bırakmaması için deneme sayısına bir üst sınır koyun.

   cURL

   Kopyala

   # $ID is data.id from the POST response. Poll every 3 seconds until status is "completed" or "failed".
   for i in $(seq 1 120); do
     RESULT=$(curl -s "https://api.photta.app/api/v1/tryon/apparel/$ID" -H "Authorization: Bearer $PHOTTA_API_KEY")
     STATUS=$(echo "$RESULT" | jq -r '.data.status')
     [ "$STATUS" = "completed" ] && break
     [ "$STATUS" = "failed" ] && echo "generation failed" && exit 1
     sleep 3
   done
   echo "$RESULT" | jq -r '.data.output_url'

4. 4

   Adım 4

   Çıktıyı kalıcı hale getirin

   Durum completed değerine geçtiğinde, data.output_url işlenmiş görseli barındırır. Ürününüzün görsel sunumu için Photta'nın CDN'ine bağımlı kalmaması adına baytları kendi depolama alanınıza indirin.

   cURL

   Kopyala

   OUTPUT_URL=$(echo "$RESULT" | jq -r '.data.output_url')
   curl -sO "$OUTPUT_URL"
   echo "Saved $(basename "$OUTPUT_URL")"

5. 5

   Adım 5

   Hata durumlarını şeffaf bir şekilde yönetin

   HTTP durum koduna göre dallara ayırın: Yetersiz credits için 402, rate limit için 429 (Retry-After başlığını dikkate alın), geçici sunucu hataları için 5xx. Her hata gövdesi, aksiyon alabileceğiniz makine tarafından okunabilir bir error.code taşır.

   cURL

   Kopyala

   case "$STATUS_CODE" in
     402) echo "insufficient_credits_error — top up before retrying" ;;
     429) echo "rate_limit_error — wait the Retry-After seconds (30 by default)" ;;
     4??) echo "$BODY" | jq '.error.type, .error.message' ;;
     5??) echo "api_error — retry with backoff" ;;
   esac

• Yetenekler

  Sanal Try-On (Giyim)

  Düz serim bir kıyafeti, seçtiğiniz ifade ve vücut ölçüsündeki bir yapay zeka mankenine giydirin. Dört ürün tipi, beş en-boy oranı.

  Oku

• Yetenekler

  Takı Try-On

  Özel olarak geliştirilmiş takı mankenleri üzerinde kolye, yüzük, bilezik ve küpelerin yakın plan çekimleri — yansımalar ve minik yüzeyler kusursuz işlenir.

  Oku

• Yetenekler

  Hayalet Manken

  Kıyafet fotoğrafından mankeni çıkarın ve iç astar yapısını olduğu gibi koruyun. 3D veya düz serim görünüm, toplu işleme uygun.

  Oku

• Yetenekler

  Gözlük Stüdyosu

  Gözlükler ve güneş gözlükleri, çerçeve ürün fotoğrafınıza birebir sadık kalacak şekilde yakın plan modeller üzerinde render edilir.

  Oku

• Yetenekler

  Detay Fotoğrafları

  Tek bir ürün fotoğrafından dikiş, kumaş, metal aksam ve etiketlerin yakın plan çekimleri; bir analiz aracı hangi alanların çekileceğini önerir.

  Oku

• Yetenekler

  Manken Üretimi

  Seçeneklerden kendi giyim veya takı mankenlerinizi üretin, ardından kimliklerini (ID) her try-on çağrısında yeniden kullanın.

  Oku

• Yetenekler

  İş Akışları

  Tek bir çağrıyla hazır bir iş akışı — örneğin takı için bir hero çekimi — çalıştırın ve tamamlanmış bir görsel seti elde edin.

  Oku

• Yetenekler

  Toplu Hayalet Manken

  Tek çağrıda koca bir askı dolusu kıyafet fotoğrafı gönderin ve tek bir batch ID poll edin; her görsel ayrı fiyatlandırılır ve izlenir.

  Oku

• API

  Photta API

  Photta API kredi tabanlı bir REST API'dir: Bir ürün fotoğrafını bir yetenek endpoint'ine POST edin, durum endpoint'ini birkaç saniyede bir sorgulayın (poll), tamamlanan görseli indirin. Sekiz yetenek, tek anahtar, tek kredi bakiyesi.

  Oku

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