↓
Rivya AI Docs

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/credits

Erforderlicher 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_credits

  • final_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 Credits

  • api_key_invalid: Der API Key kann kein Konto identifizieren

  • public_api_disabled: Die Public API ist vorübergehend deaktiviert

Verwandte Seiten