Πιστώσεις API
Κατανοήστε πώς οι κλήσεις Rivya API χρησιμοποιούν credits λογαριασμού, ελέγχους υπολοίπου, δεσμευμένα credits, επιστροφές αποτυχημένων εργασιών και αντιμετώπιση προβλημάτων credits.
Τελευταίος έλεγχος στις 2026/05/10
Το Rivya API χρησιμοποιεί το ίδιο πορτοφόλι credits λογαριασμού με το Studio.
Χρησιμοποιήστε GET /api/v1/credits για να διαβάσετε το τρέχον υπόλοιπο για τον λογαριασμό του κλειδιού API.
Endpoint
GET https://rivya.ai/api/v1/creditsΑπαιτούμενο header:
Authorization: Bearer rvya_sk_...Απάντηση
{
"current_credits": 123
}Χρέωση δημιουργίας
Όταν υποβάλλετε μια δημιουργία, το Rivya ελέγχει αν ο λογαριασμός έχει αρκετά credits.
Για εργασίες εικόνας, βίντεο και ήχου, τα credits συνήθως δεσμεύονται ή καταναλώνονται στην αρχή της εργασίας. Η απάντηση δημιουργίας περιλαμβάνει:
reserved_creditsfinal_credits
Το final_credits μπορεί να παραμείνει 0 όσο η εργασία βρίσκεται ακόμη σε ουρά ή επεξεργάζεται.
Αποτυχημένες εργασίες
Αν μια εργασία αποτύχει σύμφωνα με τους υπάρχοντες κανόνες αποτυχίας του Rivya, ο χειρισμός επιστροφής ακολουθεί την ίδια πολιτική προϊόντος με το Studio.
Χρησιμοποιήστε την Κατάσταση δημιουργίας για να επιβεβαιώσετε την τελική κατάσταση και τις Αποτυχημένες εργασίες και επιστροφές credits για το μοντέλο αποτυχίας σε επίπεδο προϊόντος.
Συνηθισμένα σφάλματα credits
insufficient_credits: ο λογαριασμός δεν έχει αρκετά creditsapi_key_invalid: το κλειδί API δεν μπορεί να αναγνωρίσει λογαριασμόpublic_api_disabled: το δημόσιο API είναι προσωρινά απενεργοποιημένο
Σχετικές σελίδες
Chat API
Χρησιμοποιήστε το Rivya Chat API για non-streaming ή SSE turns, sessions που δημιουργούνται από API, συνημμένα εικόνας file_id και token-based διακανονισμό credits.
Σφάλματα και όρια API
Χειριστείτε δημόσιους κωδικούς σφάλματος Rivya API, τιμές HTTP status, rate limits, idempotency conflicts και αποφάσεις retry.