Krea 3 API’si erken erişim aşamasındadır. Yalnızca Krea 3 betasındaki workspace’ler bu API’yi çağırabilir. Erişim talep etmek için sales@krea.ai adresiyle iletişime geçin.
Endpoint
Endpoint, standart iş yaşam döngüsünü kullanır: bir
job_id döndürür, siz de iş tamamlanana kadar GET /jobs/{job_id} adresini yoklarsınız (veya bir webhook kullanırsınız). Çıktı görüntüsü result.urls[0] içindedir.
Hızlı başlangıç: ilk görüntü düzenlemeniz
Tüm istekler bir Bearer token gerektirir. Henüz almadıysanız API Anahtarları ve Faturalandırma sayfasına bakın.1
Bir referans yükleyin
Girdi görüntünüzle
POST /assets isteği gönderin. Yanıt image_url değerini döndürür. Harici bir görüntü URL’sini veya base64 data URI’sini doğrudan image_urls içinde de iletebilirsiniz.2
Bir düzenleme oluşturun
Prompt’unuz ve referansınızla
POST /generate/image/krea/krea-3 isteği gönderin. Yanıttaki job_id değerini kaydedin.3
Sonucu alın
status değeri completed olana kadar GET /jobs/{job_id} adresini yoklayın. Çıktı result.urls[0] içindedir.Parametreler
width ve height kullanıldığında çıktı, desteklenen en yakın en boy oranına ve 1k veya 2k tuvale yuvarlanır. Piksel boyutlarının birebir tutacağı garanti edilmez.Aynı seed değerini yeniden kullanmak aynı sonuçları garanti etmez, çünkü prompt genişletme adımı çalıştırmalar arasında farklılık gösterebilir.Düşünme modları
Krea 3, üretimden önce prompt’unuzu yorumlar.thinking_mode, modelin ne kadar planlama yapacağını belirler.
thinking_mode belirtmezseniz API fast kullanır. Her iki mod da regional_edit destekler.
Bölgesel düzenlemeler
regional_edit: true ile Krea 3 yalnızca görüntünün değişmesi gereken kısımlarını yeniden üretir. Geri kalan her şey olduğu gibi kalır; böylece aynı görüntüyü kalite kaybı olmadan tekrar tekrar düzenleyebilirsiniz.
Yerel düzenlemeler için kullanın: görüntünün geri kalanının piksel düzeyinde aynı kalması gereken durumlarda bir nesneyi yeniden renklendirmek veya değiştirmek, bir öğe eklemek veya kaldırmak, bir ayrıntıyı düzeltmek ya da bir tabeladaki metni değiştirmek gibi. En son çıktı üzerinde düzenlemeleri zincirlemenin güvenli yolu budur.
Global düzenlemelerde kullanmayın: stili veya ışığı değiştirmek, mevsimi ya da günün saatini değiştirmek, yeniden kadrajlamak veya birden fazla görüntüyü yeni bir sahnede birleştirmek gibi tüm görüntünün yeniden oluşturulması gereken durumlar. Normal düzenlemeler tüm görüntüyü yeniden oluşturur; bu nedenle en son çıktıyı düzenlemeye devam ettikçe artefaktlar birikebilir.
Bölgesel düzenlemeler için image_urls içinde en az bir görüntü gerekir.
Prompt yazma
Krea 3, talimatları izleyen bir düzenleyicidir. Düzenlemeyi sade bir dille yazın:- Değişiklikle başlayın. Yalnızca uygulanmasına yardımcı olan ayrıntıları ekleyin.
- Görüntünün geri kalanı aynı kalmalıysa, bunu belirten tek bir cümleyle bitirin. Aynı kalması gereken her şeyi tek tek listelemeyin.
- Prompt birden fazla görüntü kullandığında, her görüntüden içinde ne olduğuyla bahsedin. Örneğin: “İkinci görüntüdeki spor ayakkabıyı birinci görüntüdeki kişiye giydir.”
Görüntü referansları
- Krea 3 her referansı yüklendiği çözünürlükte kullanır. 4 MP’den büyük bir referans 4 MP’ye yeniden boyutlandırılır.
- Çoğu düzenleme için yaklaşık 1 MP yeterlidir. Bir referansı göndermeden önce büyütmeyin.
- İnce ayrıntılar önemli olduğunda (küçük metinler, logolar, kumaş, geniş çekimdeki yüzler), elinizdeki en yüksek çözünürlüklü görüntüyü gönderin.
- Tek bir istekte beş veya daha fazla referans olduğunda, her referans en uzun kenarı en fazla 1536 px olacak şekilde yeniden boyutlandırılır. Tam ayrıntılı referanslar için dört veya daha az referans gönderin.
Zero Data Retention
Krea 3, kurumsal workspace’ler için Zero Data Retention desteği sunar.X-Api-Zero-Data-Retention: 1 başlığını gönderin. Zero Data Retention ile:
image_urlsiçindeki her görüntü bir base64 data URI olmalıdır.thinking_mode,fastveyahigholabilir.- Bir istek en fazla 4 görüntü referansı kullanabilir.
Fiyatlandırma
Görüntü başına fiyat; çıktı çözünürlüğüne, düşünme moduna ve görüntü referanslarına bağlıdır.İlgili
İş yaşam döngüsü
İş durumları, yoklama ve sonuçlar.
Webhooks
Yoklama yapmak yerine bir iş tamamlandığında bildirim alın.