Frage Rivya API-Generation-Jobs per öffentlicher Task-ID ab, lies queued-, processing-, succeeded- und failed-Zustände und nutze Result-URLs.

Nutze GET /api/v1/generations/{taskId}, um einen asynchronen Generation-Job zu prüfen.

Endpoint

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

Erforderlicher Header:

Authorization: Bearer rvya_sk_...

curl-Beispiel

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

Statuswerte

Öffentliche Statuswerte:

queued: Task angenommen, noch nicht abgeschlossen
processing: Generation läuft
succeeded: Ergebnis ist verfügbar
failed: Task ist fehlgeschlagen und kann ein öffentliches Fehlerobjekt enthalten

Erfolgreiche Antwort

{
  "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 ist der erste Result-URL zur Bequemlichkeit. urls enthält die öffentliche Result-URL-Liste, wenn verfügbar.

Fehlgeschlagene Antwort

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

Beginne mit einer kurzen Verzögerung und erhöhe danach die Polling-Intervalle. Vermeide enge Schleifen.

Empfohlenes Muster:

2-3 Sekunden nach dem Einreichen warten
normale Jobs alle 5-10 Sekunden abfragen
bei langen Video- und Audiojobs langsamer werden
Polling beenden, wenn der Status succeeded oder failed ist

Ownership-Grenze

Der Task muss zu demselben Rivya-Konto gehören, das hinter dem API Key steht. Wenn er nicht gefunden wird oder nicht zum Konto gehört, gibt der Endpoint not_found zurück.

Generation-Status