Χειριστείτε δημόσιους κωδικούς σφάλματος Rivya API, τιμές HTTP status, rate limits, idempotency conflicts και αποφάσεις retry.

Το Rivya API επιστρέφει σταθερούς δημόσιους κωδικούς σφάλματος σε JSON. Αντιμετωπίστε την τιμή error.code ως το συμβόλαιο ενσωμάτωσης.

Μορφή σφάλματος

{
  "error": {
    "code": "api_key_missing",
    "message": "A valid Bearer API key is required.",
    "requestId": "req_..."
  }
}

Κρατήστε το requestId στα logs σας όταν ζητάτε από την υποστήριξη του Rivya να διερευνήσει αποτυχημένο αίτημα API.

Σταθεροί κωδικοί σφάλματος

Code	HTTP status	Σημασία	Προτεινόμενη ενέργεια
`public_api_disabled`	503	Οι κλήσεις Public API είναι προσωρινά απενεργοποιημένες.	Δοκιμάστε αργότερα ή χρησιμοποιήστε χειροκίνητα το Studio.
`api_key_missing`	401	Το αίτημα δεν περιλάμβανε κλειδί Bearer API.	Στείλτε `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Το κλειδί δεν μπορεί να επαληθευτεί.	Ελέγξτε το κλειδί και εναλλάξτε το αν χρειάζεται.
`api_key_revoked`	401	Το κλειδί ανακλήθηκε στις ρυθμίσεις.	Δημιουργήστε νέο κλειδί.
`api_key_expired`	401	Το κλειδί δεν είναι πλέον έγκυρο.	Δημιουργήστε νέο κλειδί.
`api_scope_denied`	403	Το κλειδί δεν έχει το απαιτούμενο scope.	Δημιουργήστε κλειδί με το απαραίτητο scope.
`rate_limited`	429	Υπερβολικά πολλά αιτήματα στο τρέχον παράθυρο.	Κάντε backoff και δοκιμάστε αργότερα.
`validation_failed`	400	Το body, το μοντέλο, η προτροπή ή οι παράμετροι δεν είναι έγκυρα.	Συγκρίνετε το body σας με την αναφορά μοντέλου.
`not_found`	404	Η ζητούμενη εργασία δεν υπάρχει ή δεν ανήκει στον λογαριασμό.	Ελέγξτε το δημόσιο task ID και το όριο λογαριασμού.
`webhook_url_rejected`	400	Το webhook endpoint URL δεν επιτρέπεται.	Χρησιμοποιήστε δημόσιο HTTPS URL χωρίς credentials, fragments, localhost ή διευθύνσεις ιδιωτικού δικτύου.
`chat_model_not_supported`	400	Το επιλεγμένο μοντέλο δεν είναι διαθέσιμο για Chat API.	Διαβάστε το `/api/v1/models` και επιλέξτε διαθέσιμο μοντέλο chat.
`chat_session_conflict`	409	Το chat session δεν μπορεί να χρησιμοποιηθεί για αυτό το αίτημα.	Χρησιμοποιήστε session δημιουργημένο από API, που ανήκει στον ίδιο λογαριασμό και μοντέλο.
`chat_attachment_not_supported`	400	Το chat attachment δεν υποστηρίζεται.	Ανεβάστε εικόνα μέσω Files API και περάστε το `file_id`.
`idempotency_conflict`	409	Το ίδιο idempotency key επαναχρησιμοποιήθηκε με διαφορετικό input.	Χρησιμοποιήστε νέο key ή ξαναστείλτε ακριβώς το ίδιο body.
`insufficient_credits`	402	Ο λογαριασμός δεν έχει αρκετά credits.	Προσθέστε credits ή επιλέξτε αίτημα χαμηλότερου κόστους.
`internal_error`	500	Το αίτημα δεν μπόρεσε να ολοκληρωθεί.	Δοκιμάστε ξανά με idempotency ή επικοινωνήστε με την υποστήριξη με το `requestId`.

Rate limits

Το Rivya εφαρμόζει application-level Public API rate limits ανά κλειδί API. Το προεπιλεγμένο production όριο διαμορφώνεται από το PUBLIC_API_RATE_LIMIT_PER_MINUTE.

Όταν λαμβάνετε rate_limited, χρησιμοποιήστε εκθετικό backoff. Μην επαναλαμβάνετε σε σφιχτό loop.

Idempotent retries

Στείλτε Idempotency-Key με κάθε production αίτημα POST /api/v1/generations και POST /api/v1/chat/completions.

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

δημιουργήστε μοναδικό key ανά λογικό αίτημα generation
επαναχρησιμοποιήστε το ίδιο key μόνο όταν επαναλαμβάνετε το ίδιο body
αποθηκεύστε το επιστρεφόμενο δημόσιο task ID με τη δική σας εγγραφή εργασίας
για Chat API, αποθηκεύστε το επιστρεφόμενο session_id όταν θέλετε να συνεχίσετε την ίδια συνομιλία
μην επαναχρησιμοποιείτε ένα key για διαφορετικό μοντέλο, προτροπή ή params

Αν το δίκτυο αποτύχει μετά την υποβολή, δοκιμάστε ξανά με το ίδιο body και το ίδιο Idempotency-Key. Το Rivya μπορεί να επιστρέψει την αποθηκευμένη δημόσια απάντηση αντί να δημιουργήσει διπλή εργασία.

Αποφάσεις retry

Δοκιμάστε ξανά αυτά με backoff:

public_api_disabled
rate_limited
internal_error
προσωρινές αποτυχίες δικτύου

Μην δοκιμάζετε ξανά αυτά χωρίς αλλαγή input:

api_key_invalid
api_key_revoked
api_scope_denied
validation_failed
webhook_url_rejected
chat_model_not_supported
chat_session_conflict
chat_attachment_not_supported
idempotency_conflict
insufficient_credits

Σφάλματα και όρια API

Μορφή σφάλματος

Σταθεροί κωδικοί σφάλματος

Rate limits

Idempotent retries

Αποφάσεις retry

Σχετικές σελίδες

Πίνακας περιεχομένων