Geliştirici rehberi
Üretimler
Raywake üretimlerini başlat ve takip et. İş durumları, güvenli sorgulama, idempotent tekrarlar, saklanan çıktılar ve imzalı indirme linkleri.
Üretimler asenkron çalışır. Üretimi başlat, ardından iş son duruma ulaşana kadar durumunu sorgula.
Durumlar
| Alan | Tür | Açıklama |
|---|---|---|
queued | running | Kabul edildi, başlamayı bekliyor. Krediler ayrılmış durumda. |
submitting | running | Modele iletiliyor. Krediler ayrılmış durumda. |
submitted | running | Model çalışıyor. Krediler ayrılmış durumda. |
finalizing | running | Sonuç hazır ve depolamaya kaydediliyor. Krediler tahsil edildi; çıktılar birkaç saniye içinde görünür. |
succeeded | terminal | Çıktılar hazır. Krediler tahsil edildi. |
failed | terminal | Sonuç alınamadı. Krediler serbest bırakıldı. |
submission_unknown | terminal | İletim doğrulanamadı. Durum uzlaştırılana kadar krediler ayrılmış kalır; bu bir iade değildir. |
needs_review | terminal | Sonuç geldi ancak okunamadı. İnceleme bitene kadar krediler ayrılmış kalır. |
needs_reconciliation | terminal | İş, ücret kesinleştirme süresini aştı. Uzlaştırılana kadar krediler ayrılmış kalır. |
Durum sorgulama
GET /v1/jobs/{job_id} endpoint’ini 2–5 saniyede bir sorgula. Kısa işler için POST /v1/generate isteğine ?wait=true ekleyebilirsin. Bu durumda iş son duruma ulaştığında veya yaklaşık üç dakika dolduğunda, hangisi önce olursa yanıt gelir.
Idempotency
Her üretim isteğinde Idempotency-Key başlığı gerekir. Aynı anahtar ve aynı gövdeyle tekrar gönderirsen ikinci kez ücretlendirmek yerine ilk iş döner. Aynı anahtarı farklı gövdeyle kullanırsan 409 döner. Her yeni üretim için yeni bir UUID kullan.
Dosya saklama
Çıktılar 30 gün saklanır. URL imzaları 7 gün geçerlidir; yeni link için işi tekrar sorgula. Saklamak istediğin dosyaları indir.
Sıradaki: Girdiler ve dosyalar →