Polling pekerjaan generasi Rivya API berdasarkan ID tugas publik, baca status queued, processing, succeeded, dan failed, lalu gunakan URL hasil.

Gunakan GET /api/v1/generations/{taskId} untuk memeriksa pekerjaan generasi asinkron.

Endpoint

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

Header wajib:

Authorization: Bearer rvya_sk_...

Contoh curl

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

Nilai Status

Nilai status publik:

queued: tugas diterima, belum selesai
processing: generasi sedang berjalan
succeeded: hasil tersedia
failed: tugas gagal dan mungkin menyertakan objek error publik

Respons Succeeded

{
  "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 adalah URL hasil pertama untuk kemudahan. urls berisi daftar URL hasil publik saat tersedia.

Respons Failed

{
  "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."
  }
}

Panduan Polling

Mulai dengan jeda singkat, lalu tingkatkan interval polling. Hindari loop yang terlalu rapat.

Pola yang disarankan:

tunggu 2-3 detik setelah submission
polling setiap 5-10 detik untuk pekerjaan normal
perlambat untuk pekerjaan video dan audio panjang
hentikan polling saat status menjadi succeeded atau failed

Batas Kepemilikan

Tugas harus dimiliki oleh akun Rivya yang sama di balik API key. Jika tidak ditemukan atau bukan milik akun tersebut, endpoint mengembalikan not_found.

Status Generasi