Kérdezd le a Rivya API generálási feladatait nyilvános task ID alapján, olvasd a queued, processing, succeeded és failed állapotokat, és használd fel az eredmény URL-eket.

Használd a GET /api/v1/generations/{taskId} endpointot aszinkron generálási feladat ellenőrzéséhez.

Endpoint

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

Szükséges header:

Authorization: Bearer rvya_sk_...

curl példa

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

Állapotértékek

Nyilvános állapotértékek:

queued: a feladat elfogadva, még nincs kész
processing: a generálás fut
succeeded: az eredmény elérhető
failed: a feladat sikertelen, és nyilvános hibaobjektumot tartalmazhat

Sikeres válasz

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

A primary_url kényelmi okból az első eredmény URL. Az urls az elérhető nyilvános eredmény URL-listát tartalmazza.

Sikertelen válasz

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

Polling útmutató

Kezdj rövid késleltetéssel, majd növeld a lekérdezési időközöket. Kerüld a szoros ciklusokat.

Ajánlott minta:

várj 2-3 másodpercet a beküldés után
normál feladatoknál kérdezz le 5-10 másodpercenként
hosszú videó- és hangfeladatoknál lassíts
állítsd le a lekérdezést, amikor az állapot succeeded vagy failed

Tulajdonosi határ

A feladatnak ugyanahhoz a Rivya-fiókhoz kell tartoznia, amely az API-kulcs mögött áll. Ha nem található, vagy nem a fiók tulajdona, az endpoint not_found választ ad.

Generálási állapot