Credit- und Limit-Fehler

Überblick

Dieser Artikel behandelt Credit- und Limit-Fehler* in Ottili ONE — also die Meldungen und Ausfälle, die auftreten können, wenn eine KI-Anfrage, ein Ottili-Coder-Run, ein Unified-API-Aufruf oder eine Ottili-HQ-Aktion wegen Credits oder einem Limit gestoppt wird.

Zwei unabhängige Systeme können eine Anfrage stoppen, und der Fehler sagt dir, welches:

• Credits (KI-Nutzung):* Jede KI-Anfrage in Ottili ONE zieht aus genau einem Firmen-Wallet*. Die Abrechnung erfolgt prepaid über Company-Credits, und eine Anfrage ohne ausreichendes Guthaben ist fail-closed* — mit einem klaren Fehler abgelehnt, nie still überschritten.
• Limits (Rate, Budget, Modell, Kontingent):* Die Unified API begrenzt pro Company, und die Kostenkontrolle setzt pro Schlüssel und pro Unternehmen Budget- und Modell-Limits durch.

Alle interaktiven Oberflächen laufen über das Ottili-ONE-Dashboard unter [dashboard.ottili.one](https://dashboard.ottili.one); die Entwickler-Oberfläche ist die Unified API unter https://api.ottili.one/api/v1. Die öffentliche Website (ottili.one) verweist für jeden Account- und Nutzungsschritt auf das Dashboard.

Hinweis zum Status:* KI-Credits, Kostenkontrolle und Unified-API-Rate-Limiting sind Live (General Availability)*. Welche genauen Modelle, Budgets und Rate-Kontingente gelten, hängt von deinem Plan und der Konfiguration ab — die Werte stehen in den API-Headern und im Dashboard, also nie hart kodieren. Was die Status-Labels Live, Beta, Private Beta, In Development, Planned und Concept bedeuten, beschreibt der Artikel [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels).

Voraussetzungen

Bevor du mit der Fehlerbehebung beginnst, prüfe diese Punkte:

• Du bist im richtigen Unternehmen* angemeldet — Credit-Salden und Limits sind unternehmensbezogen (company_id), also zeigt ein falscher Unternehmenskontext das falsche Wallet oder die falschen Limits.
• Du weisst, welche Oberfläche* den Fehler erzeugt hat: Ottili-AI-Chat, ein Ottili-Coder-Run, ein Unified-API-Aufruf oder eine Ottili-HQ-Aktion.
• Du kannst das Dashboard öffnen und das Wallet / die Nutzung für das betroffene Unternehmen einsehen.

Häufige Credit- und Limit-Fehler

„Insufficient credits“ — die Anfrage wird abgelehnt (fail-closed)

KI-Anfragen werden prepaid über Company-Credits* abgerechnet. Reicht das Wallet-Guthaben nicht aus, wird die Anfrage mit einem klaren Fehler abgelehnt und es werden keine Credits verbraucht.

Was zu prüfen ist:

1. Öffne das Dashboard und prüfe den Wallet-Saldo des Unternehmens. Jedes Unternehmen hat genau ein Wallet mit zwei Salden:

- Enthaltene Monats-Credits* — vom Plan gewährt, zu Beginn jedes Abrechnungszeitraums zurückgesetzt.

- Wiederaufladungs-Credits* — beim Kauf von Credit-Packs hinzugefügt; sie liegen über dem enthaltenen Saldo und werden erst verbraucht, wenn die enthaltenen Credits aufgebraucht sind.

2. Sind die enthaltenen Credits aufgebraucht, entweder auf den nächsten monatlichen Reset warten oder ein Wiederaufladungs-Credit-Pack kaufen.

3. Reservierungen werden freigegeben, wenn eine Anfrage nicht ausgeführt wird (z. B. eine abgelehnte), sodass du nur für tatsächliche Arbeit zahlst.

Wie Credits, Wallet und Wiederaufladung zusammenhängen, beschreibt der Artikel [Credits und Kostennachverfolgung](/docs/understand-plans-and-credits).

Ein langer Run stoppt wegen eines Budget-Limits

Die Kostenkontrolle setzt Budget-Limits* pro API-Schlüssel und pro Unternehmen durch. Ein Budget-Limit soll lange Automationen — zum Beispiel einen Ottili-Coder-Run — vor unerwartetem Mehraufwand stoppen.

Was zu prüfen ist:

1. Stelle fest, welchen API-Schlüssel der Run verwendet hat, und prüfe dessen Kostenkontroll-Budget.

2. Erhöhe oder passe das Budget pro Schlüssel oder pro Unternehmen an, oder teile die Arbeit in kleinere Runs auf.

3. Kannst du Schlüssel-Einstellungen nicht ändern, frage einen Owner oder Admin deines Unternehmens.

Eine Anfrage wird wegen eines Modell-Limits abgelehnt

Die Kostenkontrolle setzt auch Modell-Limits* pro API-Schlüssel durch — sie entscheiden, welche Modelle (z. B. Vale oder Cairn) über einen Schlüssel erlaubt sind.

Was zu prüfen ist:

1. Wechsele auf ein Modell, das der Schlüssel erlaubt, oder lasse das Modell von einem Owner/Admin für diesen Schlüssel freigeben.

2. Rufst du die Unified API direkt auf, prüfe, ob die erlaubte-Modell-Liste des Schlüssels das angeforderte Modell enthält.

HTTP 429 „Too Many Requests“ (Unified API / Client)

Die Unified API begrenzt pro Company* mit einem Token-Bucket-Algorithmus. Ist der Bucket leer, antwortet die API mit 429 Too Many Requests und einem Retry-After-Header. Der genaue Grenzwert und das verbleibende Kontingent stehen in den RateLimit-*-Antwort-Headern. Unter hoher Systemlast greift adaptives Throttling, und nicht-kritische Endpunkte werden stärker gedrosselt.

Was zu tun ist:

1. Lies die Antwort-Header, statt Grenzwerte hart zu kodieren:

- RateLimit-Limit — maximal erlaubte Anfragen im aktuellen Fenster.

- RateLimit-Remaining — verbleibende Anfragen im aktuellen Fenster.

- RateLimit-Reset — Unix-Timestamp, wann das Fenster zurückgesetzt wird.

2. Beachte Retry-After und weiche zurück; verwende ein Client-seitiges Retry mit Jitter statt enger Schleifen.

3. Verteile die Last über die Zeit und über mehrere Fenster. Einige Endpunkte sind vom Rate-Limiting ausgenommen — verlass dich darauf nicht für Kapazitätsplanung.

Rate-Limiting in der Unified API ist Live* (Vertrag T-STAB-W7-CONTRACT-0022, gültig ab 2026-07-09). Alle Details sind in [Rate Limits](/docs/ottili-ai-api-rate-limits).

Das Wallet oder Kontingent erscheint falsch im Dashboard

Da es genau ein Firmen-Wallet pro Unternehmen gibt, deutet eine Abweichung meist auf einen dieser Punkte hin:

• Falscher Unternehmenskontext* — du siehst das Wallet eines anderen Unternehmens. Wechsele im Dashboard das aktive Unternehmen.
• Zeitpunkt* — enthaltene Credits werden zu Beginn jedes Abrechnungszeitraums zurückgesetzt; Wiederaufladungs-Credits werden erst verbraucht, nachdem der enthaltene Saldo aufgebraucht ist.
• Reservierung noch aktiv* — eine Anfrage, die noch nicht ausgeführt wurde, kann noch eine Reservierung halten; diese wird freigegeben, wenn die Anfrage beendet oder abgelehnt wird.

Jede KI-Aktion wird auf genau ein Unternehmen (company_id) aufgelöst und über Ottili Core Audit protokolliert, sodass der Verbrauch vollständig nachvollziehbar ist. Siehe [Credits und Kostennachverfolgung](/docs/understand-plans-and-credits) und [Audit-Logs über Produkte hinweg](/docs/audit-logs).

Eine Rechnung oder Zahlung ist blockiert oder hängt (Ottili HQ)

In Ottili HQ sind Rechnungen und Zahlungen unternehmensbezogen und Live*. Kann eine Zahlung nicht zugerechnet werden, wechselt die Rechnung in den Status payment_issue — sie wird nie still als bezahlt markiert. Offene Posten sind die Rechnungen, die sich noch in open, partial, overdue oder payment_issue befinden.

Was zu prüfen ist:

1. Öffne die Rechnung und lies ihren Status (open, partial, overdue, payment_issue).

2. Behebe das Anbieter- oder Validierungsproblem hinter payment_issue; danach kann die Rechnung Richtung paid wandern.

3. Ist ein Mahn-/Erinnerungs- oder Überfälligkeitszustand unerwartet, prüfe den Unternehmenskontext und die Mahn-Richtlinie.

Details sind in [Rechnungen und Zahlungsstatus](/docs/invoices-and-payments).

Credit- und Limit-Fehler über die API (Entwickler)

Für automatisierte Workflows gelten dieselben beiden Systeme:

• Credits:* Jede KI-Anfrage über die Unified API verbraucht Company-Credits. Die Abrechnung ist prepaid und fail-closed — ein unzureichendes Guthaben liefert eine klare Abweisung, keinen Teil-erfolg.
• Rate-Limits:* Die Unified API antwortet mit 429 Too Many Requests und Retry-After, wenn der pro Company gefüllte Token-Bucket leer ist. Lies die RateLimit-*-Header und weiche zurück; wiederhole nicht in einer engen Schleife.
• Kostenkontrolle:* Modell-Limits, Budget-Limits und Rate-Limits werden pro API-Schlüssel und pro Unternehmen durchgesetzt.

Authentifiziere dich mit einem Session-JWT oder API-Schlüssel (siehe [Authentifizierung und API-Schlüssel](/docs/public-api-authentication)). Der vollständige Request-/Response-Vertrag und die aktuellen Endpunkte sind im Unified-API-OpenAPI-Dokument unter https://api.ottili.one/openapi.json veröffentlicht.

Wann du den Support kontaktierst

Kontaktiere den Support, wenn:

• Credits sich nach dem Kauf eines Wiederaufladungs-Packs nicht auffüllen,
• der Wallet-Saldo über Oberflächen hinweg falsch ist und Audit-Logs es nicht erklären,
• 429-Fehler deutlich unter den in den Headern gemeldeten Limits bestehen bleiben,
• ein Budget-Limit einen legitimen Run stoppt, den du nicht anpassen kannst,
• eine Modell-Ablehnung nicht lösbar ist, weil du den Schlüssel nicht ändern kannst.

Öffne den Support unter [ottili.one/support](https://ottili.one/support) und nenne deine Unternehmens-Domain, die Oberfläche, die genaue Fehlermeldung und den Zeitstempel. Bei bekannten Ausfällen prüfe zuerst die [Status-Seite](https://status.ottili.one).

Verwandte Artikel

• [Credits und Kostennachverfolgung](/docs/understand-plans-and-credits)
• [Rate Limits](/docs/ottili-ai-api-rate-limits)
• [Fehlender Produktzugriff](/docs/missing-product-access)
• [Rechnungen und Zahlungsstatus](/docs/invoices-and-payments)
• [Pläne und Credits verstehen](/docs/understand-plans-and-credits)
• [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels)