Geliştirici rehberi
Üretim süreci
Üretimi başlat, durumunu takip et ve çıktıları indir. İstek tekrarlarını, inceleme bekleyen durumları ve dosya saklama sürelerini öğren.
Güncellendi:
Üretim henüz tamamlanmadan API’den yanıt alabilirsin. Yanıttaki job_id ile üretimin durumunu sorgula. Çıktılar hazır olduğunda aynı kayıttan indirme bağlantılarını alabilirsin.
Üretim durumları
| Alan | Tür | Açıklama |
|---|---|---|
queued | running | Üretim isteği kabul edildi ve sıraya alındı. Krediler bu üretim için ayrıldı. |
submitting | running | İstek modele gönderiliyor. Krediler ayrılmış durumda. |
submitted | running | Model üretimi sürdürüyor. Krediler ayrılmış durumda. |
finalizing | running | Üretim sonucu alındı ve çıktı dosyaları kaydediliyor. Ücret tahsil edildi; dosyalar kaydedildiğinde erişilebilir olacak. |
succeeded | terminal | Üretim tamamlandı, çıktılar hazır. Ücret tahsil edildi. |
failed | terminal | Üretim başarısız oldu. Ayrılan krediler yeniden kullanılabilir bakiyeye eklendi. |
submission_unknown | terminal | İsteğin modele ulaşıp ulaşmadığı doğrulanamadı. Durum netleşene kadar krediler ayrılmış kalır; henüz iade yapılmış değildir. |
needs_review | terminal | Modelden yanıt alındı, ancak sonuç işlenemedi. İnceleme tamamlanana kadar krediler ayrılmış kalır. |
needs_reconciliation | terminal | Üretimin ücretini kesinleştirmek için tanınan süre aşıldı. İşlem ve ücret kayıtları doğrulanana kadar krediler ayrılmış kalır. |
terminal, üretimin mutlaka başarılı olduğu anlamına gelmez. İnceleme veya mutabakat bekleyen durumlarda çıktı alınmamış ve krediler henüz iade edilmemiş olabilir.
Üretimin durumunu sorgula
GET /v1/jobs/{job_id} adresini 2–5 saniye arayla sorgula. Kısa süren üretimlerde POST /v1/generate isteğine ?wait=true ekleyebilirsin. Bu durumda yanıt, üretim son durumuna ulaştığında veya yaklaşık üç dakika dolduğunda gelir; hangisi önce gerçekleşirse o esas alınır.
İstek tekrarları (idempotency)
Her üretim isteğinde Idempotency-Key başlığını göndermen gerekir. Aynı anahtarı ve aynı istek gövdesini kullanarak isteği tekrarlarsan yeni bir üretim başlamaz; mevcut üretim kaydı döner. Aynı anahtarı farklı bir istek gövdesiyle kullanırsan 409 yanıtı alırsın.
Her yeni üretim için yeni bir UUID kullan. Aynı üretime ait isteği yeniden gönderirken ise anahtarı değiştirme.
Çıktılar ve indirme bağlantıları ne kadar süre geçerli?
Çıktılar 30 gün saklanır. İndirme bağlantılarının imzası 7 gün geçerlidir. Dosya hâlâ saklanıyorsa üretim kaydını yeniden sorgulayarak yeni bir bağlantı alabilirsin. Saklamak istediğin dosyaları 30 günlük süre dolmadan indir.
Bağlantıyı yenilemek, dosyanın 30 günlük saklama süresini yeniden başlatmaz.
GET /v1/storage?kind=output ile saklanan çıktı dosyalarını listeleyebilirsin. expires_at, dosyanın silineceği zamanı gösterir. Hem dosyaları listelemek hem üretim kaydını sorgulamak için jobs:read izni gerekir; yalnızca kendi hesabına ait dosya ve üretimler döner.
Sonraki bölüm: Girdiler ve dosyalar →