Polla Rivya API-genereringsjobb via offentligt uppgifts-ID, läs queued-, processing-, succeeded- och failed-tillstånd och använd resultat-URL:er.

Använd GET /api/v1/generations/{taskId} för att kontrollera ett asynkront genereringsjobb.

Endpoint

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

Nödvändig header:

Authorization: Bearer rvya_sk_...

curl-exempel

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

Statusvärden

Offentliga statusvärden:

queued: uppgiften har accepterats men är inte klar
processing: genereringen körs
succeeded: resultatet är tillgängligt
failed: uppgiften misslyckades och kan innehålla ett offentligt error-objekt

Svar vid lyckat resultat

{
  "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 är den första resultat-URL:en för bekvämlighet. urls innehåller listan över offentliga resultat-URL:er när den är tillgänglig.

Svar vid fel

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

Pollningsråd

Börja med en kort fördröjning och öka sedan pollningsintervallet. Undvik täta loopar.

Rekommenderat mönster:

vänta 2-3 sekunder efter inskick
polla var 5-10 sekund för normala jobb
sakta ned för långa video- och ljudjobb
sluta polla när status är succeeded eller failed

Ägarskapsgräns

Uppgiften måste tillhöra samma Rivya-konto som ligger bakom API-nyckeln. Om den inte hittas eller inte ägs av kontot returnerar endpointen not_found.

Genereringsstatus