Esegui polling dei job di generazione Rivya API tramite ID pubblico del task, leggi gli stati queued, processing, succeeded e failed, e usa gli URL dei risultati.

Usa GET /api/v1/generations/{taskId} per controllare un job di generazione asincrono.

Endpoint

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

Header richiesto:

Authorization: Bearer rvya_sk_...

Esempio curl

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

Valori di stato

Valori di stato pubblici:

queued: task accettato, non completato
processing: generazione in esecuzione
succeeded: risultato disponibile
failed: task fallito e possibile presenza di un oggetto errore pubblico

Risposta riuscita

{
  "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 è il primo URL di risultato per comodità. urls contiene la lista degli URL pubblici dei risultati quando disponibile.

Risposta fallita

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

Indicazioni per il polling

Inizia con un breve ritardo, poi aumenta gli intervalli di polling. Evita cicli serrati.

Pattern consigliato:

attendi 2-3 secondi dopo l'invio
fai polling ogni 5-10 secondi per job normali
rallenta per job video e audio lunghi
interrompi il polling quando lo stato è succeeded o failed

Perimetro di proprietà

Il task deve appartenere allo stesso account Rivya dietro la chiave API. Se non viene trovato o non appartiene all'account, l'endpoint restituisce not_found.

Stato generazione