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 2026/05/10
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 Generation-Status, um den finalen Status zu bestätigen, und Fehlgeschlagene Tasks und Credit-Rückerstattungen für das Failure-Modell 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