Interoghează sarcinile de generare din API-ul Rivya după ID-ul public, citește stările `queued`, `processing`, `succeeded` și `failed` și folosește URL-urile rezultatului.

Folosește GET /api/v1/generations/{taskId} pentru a verifica o sarcină de generare asincronă.

Endpoint

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

Header necesar:

Authorization: Bearer rvya_sk_...

Exemplu curl

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

Valori de stare

Valori publice de stare:

queued: sarcina a fost acceptată, dar nu este finalizată
processing: generarea este în curs
succeeded: rezultatul este disponibil
failed: sarcina a eșuat și poate include un obiect public de eroare

Răspuns reușit

{
  "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 este primul URL al rezultatului, oferit pentru comoditate. urls conține lista publică de URL-uri ale rezultatului atunci când aceasta este disponibilă.

Răspuns pentru o sarcină eșuată

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

Ghid de polling

Începe cu o întârziere scurtă, apoi mărește intervalele de interogare. Evită buclele prea dese.

Model recomandat:

așteaptă 2–3 secunde după trimitere
interoghează la fiecare 5–10 secunde pentru sarcinile obișnuite
mărește intervalul pentru sarcini video și audio lungi
oprește interogarea când starea devine succeeded sau failed

Limita de proprietate

Sarcina trebuie să aparțină aceluiași cont Rivya asociat cheii API. Dacă nu este găsită sau nu aparține contului, endpointul returnează not_found.

Starea generării