# Ü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.

Canonical: https://raywake.si/tr/docs/generations
Last updated: 2026-10-13

Ü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ı

**Üretim durumları**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `queued` | running | Üretim isteği kabul edildi ve sıraya alındı. Bakiye bu üretim için ayrıldı. |
| `submitting` | running | İstek modele gönderiliyor. Bakiye ayrılmış durumda. |
| `submitted` | running | Model üretimi sürdürüyor. Bakiye 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 bakiye yeniden kullanılabilir bakiyeye eklendi. |
| `submission_unknown` | terminal | İsteğin modele ulaşıp ulaşmadığı doğrulanamadı. Durum netleşene kadar bakiye 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 bakiye 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 bakiye ayrılmış kalır. |

`terminal`, üretimin mutlaka başarılı olduğu anlamına gelmez. İnceleme veya mutabakat bekleyen durumlarda çıktı alınmamış ve bakiye 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.

Yanıt alamadığın için aynı üretimi yeni bir anahtarla yeniden başlatma. Önce mevcut üretimin durumunu kontrol et veya aynı isteği aynı anahtarla tekrarla.

## Çı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](https://raywake.si/tr/docs/reference/storage) 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.

[Girdiler ve dosyalar](https://raywake.si/tr/docs/inputs)

## İlgili

- [API dokümantasyonu](https://raywake.si/tr/docs)
