Poll Rivya API-generatietaken via publieke taak-ID, lees queued-, processing-, succeeded- en failed-states en gebruik resultaat-URL's.

Gebruik GET /api/v1/generations/{taskId} om een asynchrone generatietaak te controleren.

Endpoint

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

Vereiste header:

Authorization: Bearer rvya_sk_...

curl-voorbeeld

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

Statuswaarden

Publieke statuswaarden:

queued: taak geaccepteerd, nog niet voltooid
processing: generatie wordt uitgevoerd
succeeded: resultaat is beschikbaar
failed: taak is mislukt en kan een publiek error-object bevatten

Succesresponse

{
  "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 is voor gemak de eerste resultaat-URL. urls bevat de lijst met publieke resultaat-URL's wanneer die beschikbaar is.

Faalresponse

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

Pollingadvies

Begin met een korte vertraging en vergroot daarna de pollingintervallen. Vermijd strakke loops.

Aanbevolen patroon:

wacht 2-3 seconden na indiening
poll normale taken elke 5-10 seconden
vertraag bij lange video- en audiotaken
stop met pollen wanneer de status succeeded of failed is

Eigendomsgrens

De taak moet behoren tot hetzelfde Rivya-account achter de API-sleutel. Als de taak niet wordt gevonden of niet van het account is, retourneert de endpoint not_found.

Generatiestatus