Κάντε poll σε εργασίες generation του Rivya API με δημόσιο task ID, διαβάστε καταστάσεις queued, processing, succeeded και failed, και καταναλώστε result URLs.

Χρησιμοποιήστε GET /api/v1/generations/{taskId} για να ελέγξετε μια ασύγχρονη εργασία generation.

Endpoint

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

Απαιτούμενο header:

Authorization: Bearer rvya_sk_...

Παράδειγμα curl

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

Τιμές κατάστασης

Δημόσιες τιμές κατάστασης:

queued: η εργασία έγινε δεκτή, δεν έχει ολοκληρωθεί
processing: η generation εκτελείται
succeeded: το αποτέλεσμα είναι διαθέσιμο
failed: η εργασία απέτυχε και μπορεί να περιλαμβάνει δημόσιο αντικείμενο σφάλματος

Επιτυχής απάντηση

{
  "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 είναι το πρώτο result URL για ευκολία. Το urls περιέχει τη δημόσια λίστα result URL όταν είναι διαθέσιμη.

Αποτυχημένη απάντηση

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

Ξεκινήστε με μικρή καθυστέρηση και έπειτα αυξήστε τα διαστήματα polling. Αποφύγετε σφιχτούς βρόχους.

Προτεινόμενο μοτίβο:

περιμένετε 2-3 δευτερόλεπτα μετά την υποβολή
κάντε poll κάθε 5-10 δευτερόλεπτα για κανονικές εργασίες
επιβραδύνετε για μεγάλες εργασίες βίντεο και ήχου
σταματήστε το polling όταν η κατάσταση γίνει succeeded ή failed

Όριο ιδιοκτησίας

Η εργασία πρέπει να ανήκει στον ίδιο λογαριασμό Rivya πίσω από το κλειδί API. Αν δεν βρεθεί ή δεν ανήκει στον λογαριασμό, το endpoint επιστρέφει not_found.

Κατάσταση generation