Χειριστείτε δημόσιους κωδικούς σφάλματος του Rivya API, καταστάσεις HTTP, όρια ρυθμού, συγκρούσεις ιδιοδυναμίας και αποφάσεις επανάληψης.

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

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

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

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

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

Κωδικός	Κατάσταση HTTP	Σημασία	Προτεινόμενη ενέργεια
`public_api_disabled`	503	Οι κλήσεις του Δημόσιου 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	Το κλειδί δεν έχει το απαιτούμενο πεδίο πρόσβασης.	Δημιουργήστε κλειδί με το απαραίτητο πεδίο πρόσβασης.
`rate_limited`	429	Υπερβολικά πολλά αιτήματα στο τρέχον παράθυρο.	Εφαρμόστε σταδιακή αναμονή και δοκιμάστε αργότερα.
`validation_failed`	400	Το σώμα, το μοντέλο, η προτροπή ή οι παράμετροι δεν είναι έγκυρα.	Συγκρίνετε το σώμα του αιτήματος με την αναφορά μοντέλου.
`not_found`	404	Η ζητούμενη εργασία δεν υπάρχει ή δεν ανήκει στον λογαριασμό.	Ελέγξτε το δημόσιο αναγνωριστικό εργασίας και το όριο λογαριασμού.
`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	Το ίδιο κλειδί ιδιοδυναμίας επαναχρησιμοποιήθηκε με διαφορετική είσοδο.	Χρησιμοποιήστε νέο κλειδί ή ξαναστείλτε ακριβώς το ίδιο σώμα.
`insufficient_credits`	402	Ο λογαριασμός δεν έχει αρκετές μονάδες.	Προσθέστε μονάδες ή επιλέξτε αίτημα χαμηλότερου κόστους.
`internal_error`	500	Το αίτημα δεν μπόρεσε να ολοκληρωθεί.	Δοκιμάστε ξανά με idempotency ή επικοινωνήστε με την υποστήριξη με το `requestId`.

Όρια ρυθμού

Το Rivya εφαρμόζει όρια ρυθμού του Δημόσιου API σε επίπεδο εφαρμογής ανά κλειδί API. Το προεπιλεγμένο όριο παραγωγής διαμορφώνεται από το PUBLIC_API_RATE_LIMIT_PER_MINUTE.

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

Ιδιοδύναμες επαναλήψεις

Στείλτε Idempotency-Key με κάθε αίτημα παραγωγής POST /api/v1/generations και POST /api/v1/chat/completions.

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

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

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

Αποφάσεις επανάληψης

Δοκιμάστε ξανά τα παρακάτω με σταδιακή αναμονή:

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

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

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

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

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

Όρια ρυθμού

Ιδιοδύναμες επαναλήψεις

Αποφάσεις επανάληψης

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

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