Public task ID ile Rivya API oluşturma işlerini poll edin, queued, processing, succeeded ve failed durumlarını okuyun ve sonuç URL'lerini kullanın.

Asenkron bir oluşturma işini kontrol etmek için GET /api/v1/generations/{taskId} kullanın.

Endpoint

GET https://rivya.ai/api/v1/generations/{taskId}

Gerekli header:

Authorization: Bearer rvya_sk_...

curl Örneği

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Durum Değerleri

Public durum değerleri:

queued: görev kabul edildi, henüz tamamlanmadı
processing: oluşturma çalışıyor
succeeded: sonuç kullanılabilir
failed: görev başarısız oldu ve public hata nesnesi içerebilir

Başarılı Yanıt

{
  "id": "task_public_id",
  "status": "succeeded",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 1,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": {
    "primary_url": "https://media.example/result.png",
    "urls": ["https://media.example/result.png"]
  },
  "error": null
}

primary_url, kolaylık için ilk sonuç URL'sidir. urls, mevcut olduğunda public sonuç URL listesini içerir.

Başarısız Yanıt

{
  "id": "task_public_id",
  "status": "failed",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": null,
  "error": {
    "code": "generation_failed",
    "message": "The generation failed."
  }
}

Polling Rehberi

Kısa bir gecikmeyle başlayın, sonra polling aralıklarını artırın. Sıkı döngülerden kaçının.

Önerilen kalıp:

gönderimden sonra 2-3 saniye bekleyin
normal işler için her 5-10 saniyede bir poll edin
uzun video ve ses işleri için yavaşlayın
durum succeeded veya failed olduğunda polling'i durdurun

Sahiplik Sınırı

Görev, API anahtarının arkasındaki aynı Rivya hesabına ait olmalıdır. Bulunamazsa veya hesaba ait değilse endpoint not_found döndürür.

Oluşturma Durumu