Geliştiriciler · API

Her ürünü modele giydir — tek bir API çağrısıyla.

Piktor uygulamasının arkasındaki motor, sade bir REST API olarak. Bir ürün görseli gönder; saniyeler içinde, katalog ölçeğinde fotogerçekçi model render’ları ve temiz maskeler geri al.

api.piktor.cocanlı
POST /v1/generate200 OK · 4 render · 4K + maske
<15s
görsel başına
4K
temiz maske
4
uç nokta
500+
marka üretimde
Neden API

Üretim kalitesinde görsel, bir uç nokta olarak

Uygulamanın yaptığı her şey; derleme hattından, PIM’den ya da vitrinden çağrılabilir — yükleme ekranı yok, elle sanat yönetimi yok.

01

Programatik model görselleri

Tek bir POST, düz ürün fotoğrafını fotogerçekçi model render’larına çevirir. Modeli, pozu, ışığı ve sahneyi tıklayarak değil, parametre olarak seç.

02

Katalog ölçeğinde toplu üretim

Binlerce ürünü /v1/batch üzerinden tek istekte geçir. Aynı krediler, takip edilecek tek iş — pazar yeri ölçeğine göre tasarlandı.

03

4K çıktı, temiz maskeler

Her render 4K’ya kadar çözünürlükte ve piksel hassasiyetinde alfa maskesiyle gelir — doğrudan kurguya ya da ürün sayfasına hazır.

04

Polling değil, webhook

job.succeeded olayına abone ol; görseller hazır olduğu an bitmiş URL’leri uç noktana POST edelim. Boş döngü yok.

Hızlı başlangıç

Tek istekte ilk render’ın

Bearer token ile kimlik doğrula, model ve sahne parametreleriyle bir ürün görseli gönder, ardından işi sorgula ya da webhook’u yakala. İşte tüm turun.

api.piktor.coPOST /v1/generate
curl -X POST https://api.piktor.co/v1/generate \
  -H "Authorization: Bearer $PIKTOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://cdn.yourbrand.com/sku/8842-front.jpg",
    "category": "apparel",
    "model": { "gender": "female", "body": "medium", "skin_tone": "III" },
    "scene": { "preset": "studio-daylight", "background": "seamless-bone" },
    "output": { "count": 4, "resolution": "4k", "mask": true }
  }'
Yanıt200 OK
{
  "id": "job_9f8c2a1b7d",
  "status": "succeeded",
  "credits_used": 4,
  "images": [
    {
      "url": "https://cdn.piktor.co/v1/renders/9f8c2a1b7d/01.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.piktor.co/v1/renders/9f8c2a1b7d/01-mask.png"
    },
    {
      "url": "https://cdn.piktor.co/v1/renders/9f8c2a1b7d/02.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.piktor.co/v1/renders/9f8c2a1b7d/02-mask.png"
    }
  ],
  "created_at": "2026-07-22T09:41:20Z"
}

Örnek amaçlıdır — tüm parametreler ve her sahne hazır ayarı için uygulamadaki canlı referansa bak.

Uç noktalar

Bilerek küçük bir yüzey

Dört uç nokta tüm yaşam döngüsünü kapsar — üret, kontrol et, topla, keşfet.

POST/v1/generate

Tek bir ürün görseli ile model ve sahne parametrelerinden render işi oluştur.

GET/v1/jobs/{id}

Bir işin durumunu, görsel URL’lerini ve maske URL’lerini sorgula.

POST/v1/batch

Katalog ölçeğinde çalışmalar için tek istekte çok sayıda ürünü kuyruğa al.

GET/v1/models

Kullanılabilir model hazır ayarlarını, vücut tiplerini, ten tonlarını ve sahneleri listele.

Kota & fiyatlandırma

Kredi tabanlı ve basit

Bir görsel bir kredidir — fiyatlandırma modelinin tamamı bu.

  • 1 görsel = 1 kredi. Bir istekteki ek render’lar aynı bakiyeden düşer.
  • Başarısız ya da reddedilen render’lar asla ücretlendirilmez.
  • Her yanıt bir X-Credits-Remaining başlığı döner; kullanımını kolayca ölçersin.
  • Kotalar planınla birlikte büyür; Enterprise’da tamamen kalkar.
PlanGörselKota
Free1030 istek/dk
Starter100 / ay60 istek/dk
StudioEn popüler400 / ay120 istek/dk
EnterpriseSınırsızÖzel

Krediler Piktor planından gelir — tüm paketleri fiyatlandırma sayfasında gör.

Tam referans

Dokümantasyonun tamamı uygulamada

Her parametre, webhook olayı, hata kodu ve resmî SDK — sürümlenmiş ve etkileşimli — panelinde duruyor. Bir anahtar al, referans tam yanında açılsın.

Model görsellerini programatik olarak yayına al.

Uygulamada bir anahtar oluştur, dakikalar içinde ilk çağrını yap. Ücretsiz katman dahil — kart yok.