Odpytuj zadania generowania Rivya API po publicznym ID zadania, odczytuj stany queued, processing, succeeded i failed oraz używaj URL-i wyników.

Użyj GET /api/v1/generations/{taskId}, aby sprawdzić asynchroniczne zadanie generowania.

Endpoint

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

Wymagany nagłówek:

Authorization: Bearer rvya_sk_...

Przykład curl

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

Wartości Statusu

Publiczne wartości statusu:

queued: zadanie zostało przyjęte, ale nie jest ukończone
processing: generowanie jest w toku
succeeded: wynik jest dostępny
failed: zadanie nie powiodło się i może zawierać publiczny obiekt błędu

Odpowiedź Sukcesu

{
  "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 to pierwszy URL wyniku dla wygody. urls zawiera listę publicznych URL-i wyników, gdy jest dostępna.

Odpowiedź Niepowodzenia

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

Wskazówki Dotyczące Pollingu

Zacznij od krótkiego opóźnienia, a potem zwiększaj odstępy pollingu. Unikaj ciasnych pętli.

Zalecany wzorzec:

poczekaj 2-3 sekundy po wysłaniu
odpytuj co 5-10 sekund dla zwykłych zadań
zwolnij dla długich zadań wideo i audio
zakończ polling, gdy status to succeeded albo failed

Granica Własności

Zadanie musi należeć do tego samego konta Rivya powiązanego z kluczem API. Jeśli nie istnieje albo nie należy do konta, endpoint zwraca not_found.

Status generowania