API Credits
Verstehe, wie Rivya API-Aufrufe Account Credits, Guthabenprüfungen, reservierte Credits, Rückerstattungen bei fehlgeschlagenen Tasks und Credit-Troubleshooting nutzen.
Zuletzt geprüft am 10. Mai 2026
Die Rivya API nutzt dieselbe Account-Credit-Wallet wie Studio.
Nutze GET /api/v1/credits, um das aktuelle Guthaben des Kontos zu lesen, zu dem der API Key gehört.
Endpoint
GET https://rivya.ai/api/v1/creditsErforderlicher Header:
Authorization: Bearer rvya_sk_...Antwort
{
"current_credits": 123
}Billing für Generationen
Wenn du eine Generation einreichst, prüft Rivya, ob das Konto genug Credits hat.
Bei Bild-, Video- und Audiojobs werden Credits in der Regel beim Task-Start reserviert oder verbraucht. Die Generation-Antwort enthält:
reserved_creditsfinal_credits
final_credits kann 0 bleiben, solange der Job noch in der Queue steht oder verarbeitet wird.
Fehlgeschlagene Jobs
Wenn ein Task nach Rivyas bestehenden Fehlerregeln fehlschlägt, folgt die Rückerstattungslogik derselben Produktpolicy wie Studio.
Nutze den Generierungsstatus, um den endgültigen Status zu bestätigen, und Fehlgeschlagene Aufgaben und Credit-Rückerstattungen für das Fehlermodell auf Produktebene.
Häufige Credit-Fehler
insufficient_credits: Das Konto hat nicht genug Creditsapi_key_invalid: Der API Key kann kein Konto identifizierenpublic_api_disabled: Die Public API ist vorübergehend deaktiviert
