Kontrolujte ú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á hlavička:

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 rychlé 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 dotazování

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

Doporučený vzor:

po odeslání počkejte 2-3 sekundy
běžné úlohy dotazujte každých 5-10 sekund
u dlouhých video a audio úloh zpomalte
přestaňte se dotazovat, 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í, koncový bod vrátí not_found.

Stav generování