Skip to main content

​
Genel Bakış

GET /jobs/{id} adresini defalarca sorgulamak yerine, işiniz tamamlandığında bir POST isteği almak için bir webhook URL’si sağlayabilirsiniz. Bu daha verimlidir ve gereksiz API çağrılarını azaltır.

​
Webhook Kullanma

Herhangi bir üretim isteğine X-Webhook-URL başlığını ekleyin. İş bir nihai duruma (completed, failed veya cancelled) ulaştığında, API sizin URL’nize tam iş verileriyle bir POST isteği gönderir. 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image(
  "bfl/flux-1-dev",
  {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576
  },
  { webhookUrl: "https://your-server.com/webhook" }
);

console.log(`Job ID: ${job.job_id}`);
// Tamamlandığında webhook'unuz sonuçları alacaktır

​
Webhook Yükü

İş tamamlandığında, webhook URL’niz iş verileriyle bir POST isteği alır: 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:05.000Z",
  "result": {
    "urls": ["https://..."]
  }
}

​
En İyi Uygulamalar

Hızlı yanıt verin - Hemen bir 2xx durum kodu döndürün. Gerekirse webhook verisini asenkron olarak işleyin.
Yükü doğrulayın - Sonuçları işlemeden önce job_id alanının, sizin başlattığınız bir işle eşleştiğini doğrulayın.
  • Güvenlik için HTTPS uç noktalarını kullanın
  • Yinelenen teslimatlar için idempotency uygulayın
  • Hata ayıklama için webhook alımlarını kayıt altına alın

​
Webhook ve Sorgulama Karşılaştırması

YaklaşımAvantajlarDezavantajlar
Webhook’larGerçek zamanlı bildirimler, daha az API çağrısıGenel bir uç nokta gerektirir
SorgulamaHer yerde çalışır, sunucu gerekmezDaha fazla API çağrısı, hafif gecikme
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

Webhook işlemesi ile eksiksiz örnekleri görün