Poll kerja generation Rivya API mengikut public task ID, baca keadaan queued, processing, succeeded, dan failed, serta gunakan URL hasil.

Gunakan GET /api/v1/generations/{taskId} untuk menyemak kerja generation tak segerak.

Endpoint

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

Header diperlukan:

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 awam:

queued: tugasan diterima, belum selesai
processing: generation sedang berjalan
succeeded: hasil tersedia
failed: tugasan gagal dan mungkin menyertakan objek ralat awam

Respons Berjaya

{
  "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 ialah URL hasil pertama untuk kemudahan. urls mengandungi senarai URL hasil awam apabila tersedia.

Respons Gagal

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

Mulakan dengan jeda pendek, kemudian tingkatkan selang polling. Elakkan loop yang terlalu rapat.

Corak disarankan:

tunggu 2-3 saat selepas submission
poll setiap 5-10 saat untuk kerja biasa
perlahankan untuk kerja video dan audio yang panjang
hentikan polling apabila status ialah succeeded atau failed

Boundary Pemilikan

Tugasan mesti milik akaun Rivya yang sama di belakang API key. Jika tidak ditemui atau bukan milik akaun, endpoint mengembalikan not_found.

Status Generation