Geliştirici dokümanları

neofashion.ai API'si

Ürün fotoğrafçılığı, video ve kampanya görsellerini programatik olarak üretin. Platformun kullandığı aynı API — ilk günden entegrasyonunuz için hazır.

Temel URL

Tüm endpoint'ler /api/v1 altında sürümlendirilir ve HTTPS üzerinden sunulur. Web uygulaması aynı endpoint'leri kullanır — özel, yalnızca UI'a ait route'lar yoktur.

Base URL

https://app.neofashion.ai/api/v1

Kimlik doğrulama

Her istek bearer token ile doğrulanır. İki token türü desteklenir ve ikisi de aynı çalışma alanı bağlamına çözümlenir.

API anahtarı

Sunucudan sunucuya entegrasyonlar için. Anahtarları çalışma alanı ayarlarından oluşturun; her anahtar çalışma alanınıza özeldir. Enterprise planlarda sunulur.

Authorization: Bearer ne_live_xxxxxxxxxxxx

Oturum JWT

Girişte web uygulaması tarafından verilir. Platformun kendi arayüzünde kullanılır ve kısa ömürlü, kullanıcı kapsamlı çağrılar için uygundur.

Authorization: Bearer eyJhbGci...

Tüm istekler denetim ve faturalandırma amacıyla bir source alanı (ui veya api) ve isteğe bağlı bir api_key_id içerir.

Endpoint'ler

Temel üretim ve okuma endpoint'leri. Video ve toplu üretim gibi uzun süren işler asenkron çalışır — üretimi sorgulayın veya uygulamadaki durum güncellemelerini takip edin.

Yöntem	Endpoint	Açıklama
POST	`/api/v1/generate/image`	Tek bir ürün fotoğrafı oluşturun
POST	`/api/v1/generate/video`	Kısa bir moda videosu oluşturun
POST	`/api/v1/generate/bulk`	Zaman uyumsuz toplu oluşturma işi
POST	`/api/v1/sketch-to-photo`	Taslak → kampanya kalitesinde fotoğraf
GET	`/api/v1/generations`	Nesiller listesi (sayfalandırılmış)
GET	`/api/v1/generations/:id`	Nesil ayrıntısı + durum
GET	`/api/v1/credits/balance`	Mevcut kredi bakiyesi
GET	`/api/v1/personas`	Çalışma alanı kişileri
GET	`/api/v1/models`	Marka DNA'sı / personalar API'si

Yanıt yapısı

Her endpoint aynı zarfı döndürür: data, meta (kullanılan krediler, kalan krediler, istek kimliği) ve error. Data veya error'dan yalnızca biri ayarlanır.

Başarılı

{
  "data": {
    "id": "gen_01hwz...",
    "status": "completed",
    "output_url": "https://...",
    "credits_used": 50
  },
  "meta": {
    "credits_used": 50,
    "credits_remaining": 7950,
    "request_id": "req_01hwz..."
  },
  "error": null
}

Hata

{
  "data": null,
  "meta": { "request_id": "req_01hwz..." },
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Credit balance too low for this operation.",
    "details": { "required": 50, "available": 20 }
  }
}

Hız limitleri

Limitler çalışma alanı başına uygulanır. Bir limit aşıldığında API, 429 RATE_LIMITED ile retry-after header'ını döndürür.

Plan	Hız limiti
Enterprise	`Özel — SLA ile sözleşmeye göre kararlaştırılır`

Hata kodları

Hatalar, error alanında sabit bir code, kullanıcı tarafından okunabilir bir mesaj ve yapılandırılmış ayrıntılarla döner.

Kod	HTTP	Anlamı
`INSUFFICIENT_CREDITS`	402	Çalışma alanı bakiyesi istenen işlem için yetersiz. Devam etmek için bakiye yükleyin veya planınızı yükseltin.
`UNAUTHORIZED`	401	Token eksik, süresi dolmuş veya geçersiz.
`FORBIDDEN`	403	Token geçerli, ancak plan veya rol bu işleme izin vermiyor.
`NOT_FOUND`	404	Kaynak mevcut değil veya başka bir çalışma alanına ait.
`RATE_LIMITED`	429	Çok fazla istek — belirtilen süreden sonra yeniden deneyin.
`PROVIDER_ERROR`	502	Bir üst AI sağlayıcısı başarısız oldu. Krediler iade edildi; istek yeniden denenebilir.

API erişimi

Entegre olmaya hazır mısınız?

API erişimi, rehberli onboarding ve SLA ile Enterprise planlarda sunulur. Demo talep edin; entegrasyonunuzu birlikte gözden geçirelim.

Demo talep et Fiyatları görüntüleyin