Crediti API
Comprendi come le chiamate Rivya API usano i crediti account, i controlli del saldo, i crediti riservati, i rimborsi per task falliti e la risoluzione dei problemi sui crediti.
Ultima revisione il 2026/05/10
Rivya API usa lo stesso wallet di crediti account di Studio.
Usa GET /api/v1/credits per leggere il saldo attuale dell'account associato alla chiave API.
Endpoint
GET https://rivya.ai/api/v1/creditsHeader richiesto:
Authorization: Bearer rvya_sk_...Risposta
{
"current_credits": 123
}Fatturazione delle generazioni
Quando invii una generazione, Rivya controlla se l'account ha crediti sufficienti.
Per task immagine, video e audio, i crediti vengono di solito riservati o consumati all'avvio del task. La risposta della generazione include:
reserved_creditsfinal_credits
final_credits può restare 0 mentre il task è ancora in coda o in elaborazione.
Task falliti
Se un task fallisce secondo le regole di errore esistenti di Rivya, la gestione del rimborso segue la stessa policy di prodotto di Studio.
Usa stato generazione per confermare lo stato finale e task falliti e rimborsi crediti per il modello di errore a livello prodotto.
Errori comuni sui crediti
insufficient_credits: l'account non ha crediti sufficientiapi_key_invalid: la chiave API non riesce a identificare un accountpublic_api_disabled: la public API è temporaneamente disabilitata