Dotazujte úlohy generování Rivya API podle veřejného ID úlohy, čtěte stavy queued, processing, succeeded a failed a používejte výsledné URL.

Použijte GET /api/v1/generations/{taskId} pro kontrolu asynchronní úlohy generování.

Koncový bod

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

Požadovaný header:

Authorization: Bearer rvya_sk_...

Příklad curl

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

Hodnoty stavu

Veřejné hodnoty stavu:

queued: úloha byla přijata, ale není dokončená
processing: generování běží
succeeded: výsledek je dostupný
failed: úloha selhala a může obsahovat veřejný objekt chyby

Odpověď při úspěchu

{
  "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 je první výsledné URL pro pohodlné použití. urls obsahuje seznam veřejných výsledných URL, pokud je dostupný.

Odpověď při selhání

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

Doporučení pro polling

Začněte krátkou prodlevou a potom prodlužujte intervaly pollingu. Vyhněte se těsným smyčkám.

Doporučený vzor:

po odeslání počkejte 2-3 sekundy
běžné úlohy pollujte každých 5-10 sekund
u dlouhých video a audio úloh zpomalte
přestaňte pollovat, když je stav succeeded nebo failed

Hranice vlastnictví

Úloha musí patřit ke stejnému účtu Rivya za daným API klíčem. Pokud neexistuje nebo ji účet nevlastní, endpoint vrátí not_found.

Stav generování