Genel Bakış
Tüm üretim istekleri aynı temel yaşam döngüsünü izler:İş Durumları
queued İş, işlenmek üzere kuyrukta bekliyor backlogged İş, mevcut eşzamanlılık limitiniz nedeniyle bekliyor scheduled İş kabul edildi ve işlenmek üzere programlandı processing İş, bir işçi tarafından aktif olarak işleniyor sampling İş, çıktı örnekleri üretiyor intermediate-complete İşin bir ara sonucu var ve işlenmeye devam edebilir completed İş başarıyla tamamlandı, sonuçresult.urls içinde bulunuyor
failed İş, bir hata nedeniyle başarısız oldu; ayrıntılar result.error içinde
cancelled İş, kullanıcı veya sistem tarafından iptal edildi
Başarısızlıklar ve İptal
İşler birkaç nedenle başarısız olabilir:- Üretim hizmetinden gelen API hataları
- Geçersiz parametreler veya desteklenmeyen yapılandırmalar
- İçerik denetimi (NSFW filtreleme)
- Otomatik zaman aşımı tespiti (barındırılan araçlar için 3 dakika, harici sağlayıcılar için 2 saat)
/jobs/{id} adresine bir DELETE isteği gönderin. Not: İşler yalnızca queued veya processing durumundayken iptal edilebilir.
Önemli: Başarısız ve iptal edilen işler için ücret alınmaz. Yalnızca tamamlanan işler için ödeme yaparsınız.
İş Durumunu Kontrol Etme
/jobs/{id} adresine bir GET isteği ile iş durumunu sorgulayın. Önerilen uygulamalar:
- İş beklerken her 2-5 saniyede bir sorgulama yapın (
backlogged,queued,scheduled,processing,samplingveyaintermediate-complete) - Uzun süren işler için üstel geri çekilme kullanın
- Durum completed, failed veya cancelled olduğunda sorgulamayı durdurun
- Bazı işler, processing sırasında yanıtlarda önizleme görüntüleri içerebilir
Sonraki Adımlar
Webhooks
İşler tamamlandığında bildirim alın
Hız Sınırları
Plan seviyesine göre API limitlerini anlayın
Model API'leri
Kullanılabilir tüm uç noktaları ve parametreleri keşfedin
API Anahtarları ve Faturalandırma
API anahtarlarınızı oluşturun ve yönetin