Crédits API
Comprenez comment les appels API Rivya utilisent les crédits du compte, les contrôles de solde, les crédits réservés, les remboursements de tâches échouées et le dépannage des crédits.
Dernière révision le 2026/05/10
L'API Rivya utilise le même portefeuille de crédits de compte que le Studio.
Utilisez GET /api/v1/credits pour lire le solde actuel du compte associé à la clé API.
Endpoint
GET https://rivya.ai/api/v1/creditsEn-tête requis :
Authorization: Bearer rvya_sk_...Réponse
{
"current_credits": 123
}Facturation des générations
Lorsque vous soumettez une génération, Rivya vérifie si le compte dispose de suffisamment de crédits.
Pour les tâches image, vidéo et audio, les crédits sont généralement réservés ou consommés au démarrage de la tâche. La réponse de génération inclut :
reserved_creditsfinal_credits
final_credits peut rester à 0 tant que la tâche est encore en file d'attente ou en cours de traitement.
Tâches échouées
Si une tâche échoue selon les règles d'échec existantes de Rivya, le traitement du remboursement suit la même politique produit que le Studio.
Utilisez Statut de génération pour confirmer le statut final et Tâches échouées et remboursements de crédits pour le modèle d'échec au niveau produit.
Erreurs courantes de crédits
insufficient_credits: le compte n'a pas assez de créditsapi_key_invalid: la clé API ne peut pas identifier un comptepublic_api_disabled: l'API publique est temporairement désactivée
Pages associées
API Chat
Utilisez l'API Chat de Rivya pour des tours sans streaming ou en SSE, des sessions créées par l'API, des pièces jointes image file_id et un règlement des crédits basé sur les tokens.
Erreurs et limites API
Gérez les codes d'erreur publics de l'API Rivya, les statuts HTTP, les limites de débit, les conflits d'idempotence et les décisions de nouvelle tentative.