Genel Bakış
GET /jobs/{id} adresini sorgulamak yerine Krea’ya bir webhook URL’si verin. İş tamamlandığında Krea işi bu URL’ye gönderir.
Webhook Kullanma
Herhangi bir üretim isteğineX-Webhook-URL başlığını ekleyin. İş tamamlandığında, başarısız olduğunda veya iptal edildiğinde Krea bu URL’ye bir POST isteği gönderir.
Webhook Yükü
İstek gövdesi,GET /jobs/{id} yanıtıyla aynı yapıya sahiptir:
İmzaları Doğrulama
Krea her webhook’u Ed25519 ile imzalar. Bir yüke güvenmeden önce imzayı doğrulayın ve imzası olmayan istekleri reddedin.
Krea, zaman damgası, URL, meta veriler ve ham istek gövdesinin satır sonlarıyla birleştirilmesiyle elde edilen değerin küçük harfli hex SHA-256 özetini imzalar:
X-Krea-Webhook-Urldeğerinin, işle birlikte gönderdiğinizX-Webhook-URLile tam olarak eşleştiğini kontrol edin.- Zaman damgasının sunucunuzun geçerli saatinden en fazla 5 dakika farklı olduğunu kontrol edin.
- İmza,
https://api.krea.ai/.well-known/jwks.jsoniçindeki herhangi bir anahtarla doğrulanıyorsa isteği kabul edin. Anahtarları en fazla 24 saat önbelleğe alın. Krea yeni bir anahtarı, onunla imzalamaya başlamadan 24 saat önce yayınlar.
express.raw(), Fetch API çerçevelerinde await request.arrayBuffer() veya Flask’ta request.get_data() kullanın. Eksik bir X-Krea-Webhook-Metadata başlığını boş bir dize olarak kabul edin.
Teslimat ve Yeniden Denemeler
15 saniye içinde bir2xx döndürün. İstek zaman aşımına uğrarsa, bağlantı kurulamazsa veya 5xx, 408, 423, 425 ya da 429 yanıtı alırsa Krea, her seferinde yeni bir zaman damgası ve imzayla yaklaşık 10 dakika boyunca yeniden dener. Krea diğer 4xx yanıtları için yeniden deneme yapmaz.
Aynı iş birden fazla kez gelebilir, bu nedenle yinelenenleri job_id ve status alanlarına göre ayıklayın.
Webhook ve Sorgulama Karşılaştırması
HTTP isteği alabilen bir sunucunuz varsa webhook kullanın. İstemci tarafı uygulamalar için veya genel bir uç nokta sunamıyorsanız sorgulama kullanın.
Sonraki Adımlar
İş Yaşam Döngüsü
İş durumları ve durum sorgulaması hakkında bilgi edinin
Kod Örnekleri
API ile baştan sona bir görsel üretin