Fehlerbehebung

Gehen Sie das Symptom durch, das Ihrer Beobachtung entspricht. In fast allen Fällen ist der Tab „Logs“ das schnellste Diagnosewerkzeug – er zeigt den Status jeder Anfrage und das Fehlermuster (ein Schlüssel? ein Modell? alles?). Siehe Aktivität und Logs.

Anfragen werden blockiert

Jede Anfrage schlägt mit 402 insufficient_credits fehl

Ursache: Das Modul ist für diese Einrichtung nicht aktiviert, oder das Prepaid-Guthaben ist aufgebraucht (der Tab „Overview“ zeigt dann „Your balance is depleted. Inference requests will be blocked until you top up.“). Bei API-Schlüsseln gibt eine Einrichtung, in der Model Router nicht aktiviert ist, stattdessen 403 „Model Router is not enabled for this facility“ zurück.

Lösung: Aktivieren Sie Model Router auf der Seite Welcome to Model Router (siehe Erste Schritte) und laden Sie anschließend unter Budgets & Limits → Balance & Top-up Guthaben auf. Anfragen werden wenige Augenblicke nach der Gutschrift des Guthabens fortgesetzt. Damit dies nicht erneut passiert, aktivieren Sie die automatische Aufladung. Siehe Budgets und Aufladungen.

Anfragen schlagen mit 402 budget_exceeded fehl

Ursache: Ein Ausgabenlimit wurde erreicht. Die Fehlermeldung nennt den Zeitraum (täglich / monatlich / gesamt) und – bei täglichen und monatlichen Limits – genau, wann es in der Zeitzone Ihrer Einrichtung zurückgesetzt wird. Es kann sich um das kontoweite Limit oder um ein Limit für den jeweiligen Schlüssel oder verbundenen Dienst handeln (bei einem bereichsbezogenen Limit lautet die Meldung „This key's“ / „This agent's“).

Lösung: Warten Sie entweder bis zur angegebenen Zurücksetzung, erhöhen Sie das Limit (Budgets & Limits → Spend Limits oder die Konfiguration des Schlüssels bzw. Dienstes) oder verwenden Sie – bei der festen Gesamtobergrenze – Reset hard cap. Die Seite „Spend Limits“ zeigt genau, welche Limits den Status „Limit reached“ haben.

Anfragen schlagen mit 403 content_policy_violation fehl

Ursache: Der Prompt hat einen Inhaltsfilter im Modus block oder den Schutz vor Prompt-Injection ausgelöst.

Lösung: Überprüfen Sie Settings → Guardrails. Wenn eine Integration berechtigterweise andere Regeln benötigt, verwenden Sie deren Schalter Override facility guardrails, statt die einrichtungsweite Richtlinie zu lockern. Siehe Guardrails.

Anfragen schlagen mit 429 fehl

Ursache: Der Schlüssel oder verbundene Dienst hat sein Ratenlimit für Requests / min oder Tokens / min überschritten.

Lösung: Warten Sie und versuchen Sie es erneut, oder erhöhen Sie die Ratenlimits in der Konfiguration des Schlüssels oder Dienstes (leer = unbegrenzt). Siehe API-Schlüssel.

Ein bestimmtes Modell gibt Fehler zurück, andere funktionieren

Ursache: Das Modell ist möglicherweise für Ihre Einrichtung deaktiviert, durch die Modellbeschränkung des Schlüssels ausgeschlossen, oder der Anbieter hat Probleme.

Lösung: Prüfen Sie Settings → Models (ist es aktiviert?), die Liste Restrict models des Schlüssels und Activity → Performance → Reliability & performance by model für die Fehlerrate des Modells im Zeitverlauf.

Probleme mit API-Schlüsseln

401 Unauthorized

Ursache: Beim Code invalid_api_key („Missing or invalid API key“) fehlt der Header Authorization: Bearer … oder ist fehlerhaft. Ohne Code („Invalid API key“) ist der Schlüssel unbekannt (falsch eingegeben oder ein altes Secret nach einem rotate) oder revoked.

Lösung: Prüfen Sie das Header-Format und den Status des Schlüssels unter Settings → Service Access & API Keys. Reaktivieren Sie einen widerrufenen Schlüssel, oder aktualisieren Sie Ihren Dienst auf das neue Secret, wenn der Schlüssel rotiert wurde.

Ich habe das Schlüssel-Secret verloren

Das Secret wird nur einmal bei der Erstellung angezeigt und kann nicht wiederhergestellt werden. Verwenden Sie Rotate – es wird ein neues Secret ausgegeben (einmalig angezeigt), und der Schlüssel behält seine Bezeichnung, seine Limits und seinen Verlauf. Aktualisieren Sie jeden Dienst, der den Schlüssel verwendet: „You will need to reconfigure any services still using the old key.“

Der Schlüssel funktioniert, aber die Nutzung erscheint unter dem falschen Namen

Schlüssel werden in „Activity“ und „Logs“ anhand ihres Label identifiziert. Bearbeiten Sie den Schlüssel und vergeben Sie eine aussagekräftige Bezeichnung; geben Sie jedem System einen eigenen Schlüssel, statt einen gemeinsam zu nutzen.

Agentenprobleme

Ein Agent wird als „Offline“ angezeigt

Ursache: Das Gerät ist ausgeschaltet oder hat keine Verbindung – das betrifft die Konnektivität des Geräts, nicht eine Einstellung von Model Router.

Lösung: Prüfen Sie Stromversorgung und Netzwerk des Geräts. Seine Zugriffskonfiguration bleibt unverändert und funktioniert wieder, sobald es sich erneut verbindet.

Ein Agent reagiert nicht mehr auf KI-Anfragen

Prüfen Sie der Reihe nach:

1. Guthaben – ein aufgebrauchtes Guthaben blockiert alle Agenten (der Agent zeigt einen Status, der Guthaben erfordert). Laden Sie Guthaben auf.
2. Limits pro Dienst – Settings → Service Access & API Keys → Connected Services: Zeigt der Agent „Limit reached“ an? Erhöhen Sie das Limit oder warten Sie, bis es zurückgesetzt wird.
3. Kontolimits – Budgets & Limits → Spend Limits.
4. Logs – filtern Sie nach dem Agenten, um den tatsächlichen Fehler bei seinen Anfragen zu sehen.

Fragen zu Guthaben und Abrechnung

Die Ausgabenzahlen wirken verzögert

Die Werte Available balance und Spent today werden live angezeigt. Monthly usage wird alle 15 Minuten mit Ihrem Guthaben abgeglichen, daher kann es einige Minuten dauern, bis sehr aktuelle Ausgaben dort erscheinen. Der Transaktionsverlauf listet nur Aufladungen und Guthabenanpassungen auf, daher erscheint die Nutzung dort nie.

Die automatische Aufladung wurde nicht ausgeführt

Prüfen Sie die Seite „Balance & Top-up“ auf ein Banner: keine Karte hinterlegt, Karte erfordert Authentifizierung oder Karte abgelehnt. Beheben Sie das Problem mit der Karte (Update card / Edit payment details) oder laden Sie manuell auf. Die Prüfungen für die automatische Aufladung laufen etwa alle 15 Minuten, daher kann es einige Minuten dauern, bis ein gerade unterschrittener Schwellenwert eine Aufladung auslöst.

Eine Aufladung ist fehlgeschlagen

„Additional card authentication is required. Please try again.“ – versuchen Sie es erneut; Ihre Bank fordert möglicherweise eine Verifizierung an. „Top-up could not be completed.“ – die Belastung wurde abgelehnt; prüfen Sie die Karte oder versuchen Sie einen anderen Betrag. Guthaben wird nur gutgeschrieben, wenn die Belastung erfolgreich ist.

Meine Karte wurde belastet, aber das Guthaben hat sich nicht verändert

Aufladungen werden sofort gutgeschrieben – aktualisieren Sie die Seite. Wenn das Guthaben eine erfolgreiche Belastung weiterhin nicht widerspiegelt, notieren Sie sich die Transaction ID und die Payment reference aus dem Detailbereich der Transaktion (oder Ihrer Kartenabrechnung) und stellen Sie eine Supportanfrage.

Fragen zu Logs und Analysen

Eine gerade gestellte Anfrage ist noch nicht in den Logs

Aktivieren Sie die Live-Aktualisierung (oder klicken Sie auf Refresh now). Anfragen erscheinen normalerweise innerhalb weniger Augenblicke; unter Last kann es etwas länger dauern.

Die Logs zeigen ein Modell, das ich nicht angefordert habe

Wenn Sie model: "auto" gesendet haben, zeigen die Logs das Modell, zu dem der Auto Router aufgelöst hat – öffnen Sie die Details der Anfrage, um Requested model: auto zu sehen. Das ist so vorgesehen. Siehe Modelle.

Zeilen zeigen „No charge“

Fehlgeschlagene oder leere Antworten, die nichts kosten, werden mit No charge gekennzeichnet – sie werden der Vollständigkeit halber erfasst, haben aber kein Guthaben verbraucht.

Mein CSV-Export ist kleiner als erwartet

Rohexporte sind auf 25,000 Zeilen begrenzt – grenzen Sie den Datumsbereich ein oder verwenden Sie einen zusammengefassten Export. Beachten Sie außerdem: „Summaries cover whole days, so a sub-day or graph selection is widened to full days.“