Poll Rivya API-genereringsjobs efter offentligt task-ID, læs queued-, processing-, succeeded- og failed-tilstande, og brug resultat-URL'er.

Brug GET /api/v1/generations/{taskId} til at kontrollere et asynkront genereringsjob.

Endpoint

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

Påkrævet header:

Authorization: Bearer rvya_sk_...

curl-eksempel

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

Statusværdier

Offentlige statusværdier:

queued: opgaven er accepteret, men ikke færdig
processing: generationen kører
succeeded: resultatet er tilgængeligt
failed: opgaven fejlede og kan inkludere et offentligt fejlobjekt

Svar ved succes

{
  "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 er den første resultat-URL af praktiske grunde. urls indeholder listen over offentlige resultat-URL'er, når den er tilgængelig.

Svar ved fejl

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

Start med en kort forsinkelse, og øg derefter pollingintervallerne. Undgå tætte løkker.

Anbefalet mønster:

vent 2-3 sekunder efter indsendelse
poll hvert 5-10. sekund for normale jobs
sænk tempoet for lange video- og audiojobs
stop polling, når status er succeeded eller failed

Ejerskabsgrænse

Opgaven skal tilhøre den samme Rivya-konto bag API-nøglen. Hvis den ikke findes eller ikke ejes af kontoen, returnerer endpointet not_found.

Genereringsstatus