Photta API

Photta API REST ile sanal try-on, hayalet manken ve ürün fotoğrafçılığı

Tek cümlede

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.

API anahtarı alın Dokümantasyonu okuyun

Yetenekler: 8 yetenek
Rate limit: 600 istek/dk
Kimlik Doğrulama: Bearer anahtarı
Desen: asenkron, polling

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

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')

const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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."
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/tryon/apparel",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "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."
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Yetenekler

Yeteneklerine göre tüm endpoint'ler

Metot, yol, credits ve tipik süre; doğrudan API dokümanlarından. Bu sayfadaki veriler, en altta gösterilen tarihte dokümanlara göre kontrol edilmiştir.

Diller

Henüz SDK yok — ve ihtiyacınız da yok.

Photta dokümanlarının bugün tam olarak önerdikleriyle birebir eşleşen, yapıştırmaya hazır üç rehber.

Hızlı Başlangıç

Kaydolmaktan ilk görsele beş dakikada.

Her yetenek aynı deseni izler: kimlik doğrula, gönder, sorgula (poll). Bir kez öğrenin.

Adım 1: ai.photta.app adresinden kaydolun ve Developers panelinden canlı bir API key oluşturun.
Adım 2: Authorization başlığında anahtarınızla işi POST edin — API hemen bir oluşturma ID'si döndürür.
Adım 3: Durum completed değerine dönene kadar aynı endpoint'i her 3 saniyede bir sorgulayın (poll), ardından sonuç URL'sini indirin.

Hızlı başlangıç

Sorular

Geliştiricilerin kaydolmadan önce sorduğu sorular

Photta API nedir?

Photta'nın API'si, ürün fotoğraflarınızdan profesyonel moda fotoğrafları üreten kredi tabanlı bir REST servisidir. Geliştiricilerin kendi araçlarını inşa edebilmeleri için sekiz yetenek olarak sunulan; sanal giysi try-on, takı try-on ve hayalet manken çıkarma gibi Photta'nın son kullanıcı uygulamalarını destekleyen aynı pipeline'dır.

Nasıl API key alırım?

ai.photta.app adresinden kaydolun, panelin Developers bölümünü açın, Generate API key butonuna tıklayın. Canlı anahtarınız `photta_live_` ile başlar ve ardından 32 onaltılık (hex) karakter gelir. Bir ortam değişkeninde saklayın — asla kaynak kod yönetimine göndermeyin, asla tarayıcıya iletmeyin.

Ücretsiz bir katman var mı?

Yeni hesaplar, herhangi bir yetenekte harcayabileceğiniz deneme kredisi (credits) alır. Yayına almaya hazır olduğunuzda, daha yüksek aylık kredi bakiyesine sahip bir plana abone olun. Rate limit her planda aynıdır: API key başına dakikada 600 istek. Çağrı başına minimum sınır yoktur.

Oluşturma işlemi ne kadar sürer?

Try-on ve hayalet manken işleri genellikle 1.5 ila 4 dakika içinde tamamlanır; gözlük çekimleri, detay fotoğrafları ve iş akışı görselleri 20 ila 60 saniyede; manken oluşturma ise 30 ila 60 saniyede sonuçlanır. Her oluşturma endpoint'i asenkrondur: POST anında bir oluşturma ID'si döndürür ve iş bitene kadar her 3 ila 5 saniyede bir sorgularsınız (poll). Yönetilmesi gereken uzun süreli bir HTTP bağlantısı yoktur.

Resmi bir Photta SDK'sı var mı?

Henüz yok. Desteklenen entegrasyon yöntemi cURL, Node'un yerel fetch fonksiyonu veya Python'un requests kütüphanesi üzerinden doğrudan REST çağrılarıdır — her üçü de bu sitede, her yetenek için uçtan uca belgelenmiştir.

Referans

Dokümanların birden fazla kez açacağınız bölümleri.

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.

API anahtarı alın Hızlı başlangıç

8 yetenek
600 istek/dk
Bearer anahtarı
asenkron, polling