Interogheaza joburile de generare Rivya API dupa ID-ul public al sarcinii, citeste starile queued, processing, succeeded si failed si consuma URL-urile rezultatului.

Foloseste GET /api/v1/generations/{taskId} pentru a verifica un job asincron de generare.

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 status

Valori publice de status:

queued: sarcina a fost acceptata, dar nu este completa
processing: generarea ruleaza
succeeded: rezultatul este disponibil
failed: sarcina a esuat si poate include un obiect public de eroare

Raspuns reusit

{
  "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 de rezultat, pentru comoditate. urls contine lista publica de URL-uri ale rezultatului atunci cand este disponibila.

Raspuns esuat

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

Incepe cu o intarziere scurta, apoi mareste intervalele de polling. Evita buclele stranse.

Model recomandat:

asteapta 2-3 secunde dupa trimitere
interogheaza la fiecare 5-10 secunde pentru joburi normale
incetineste pentru joburi video si audio lungi
opreste pollingul cand statusul este succeeded sau failed

Limita de proprietate

Sarcina trebuie sa apartina aceluiasi cont Rivya din spatele cheii API. Daca nu este gasita sau nu este detinuta de cont, endpointul returneaza not_found.

Statusul generarii