Problemen oplossen

Ga uit van het symptoom dat overeenkomt met wat je ziet. In bijna alle gevallen is het tabblad Logs de snelste manier om een probleem te onderzoeken: het toont de status van elk verzoek en het patroon van de fouten (één sleutel? één model? alles?). Zie Activiteit en logs.

Verzoeken worden geblokkeerd

Elk verzoek mislukt met 402 insufficient_credits

Oorzaak: de module is niet ingeschakeld voor deze faciliteit, of het vooraf betaalde saldo is op (het tabblad Overview toont dan "Your balance is depleted. Inference requests will be blocked until you top up."). Voor API-sleutels geeft een faciliteit waar Model Router niet is ingeschakeld in plaats daarvan 403 "Model Router is not enabled for this facility".

Oplossing: schakel Model Router in vanaf de pagina Welcome to Model Router (zie Aan de slag) en waardeer daarna op onder Budgets & Limits → Balance & Top-up. Verzoeken worden binnen enkele ogenblikken nadat het saldo is bijgeschreven weer verwerkt. Schakel automatisch opwaarderen in om herhaling te voorkomen. Zie Budgetten en opwaarderen.

Verzoeken mislukken met 402 budget_exceeded

Oorzaak: er is een bestedingslimiet bereikt. De foutmelding vermeldt om welke periode het gaat (dagelijks / maandelijks / totaal) en, bij dagelijks en maandelijks, precies wanneer de limiet wordt teruggezet in de tijdzone van je faciliteit. Het kan gaan om de limiet voor het hele account of om een limiet op de specifieke sleutel of gekoppelde service (de melding zegt "This key's" / "This agent's" wanneer de limiet daartoe beperkt is).

Oplossing: wacht tot het vermelde moment waarop de limiet wordt teruggezet, verhoog de limiet (Budgets & Limits → Spend Limits, of de configuratie van de sleutel of service) of gebruik, voor het harde totaalplafond, Reset hard cap. De pagina Spend Limits toont precies welke limieten op "Limit reached" staan.

Verzoeken mislukken met 403 content_policy_violation

Oorzaak: de prompt kwam overeen met een inhoudsfilter in de modus block of met de bescherming tegen promptinjectie.

Oplossing: controleer Settings → Guardrails. Als één integratie terecht andere regels nodig heeft, gebruik dan de schakelaar Override facility guardrails van die integratie in plaats van het beleid voor de hele faciliteit te versoepelen. Zie Guardrails.

Verzoeken mislukken met 429

Oorzaak: de sleutel of gekoppelde service heeft de snelheidslimiet Requests / min of Tokens / min overschreden.

Oplossing: wacht even en probeer het opnieuw, of verhoog de snelheidslimieten in de configuratie van de sleutel of service (leeg = onbeperkt). Zie API-sleutels.

Eén bepaald model geeft fouten, andere werken wel

Oorzaak: het model is mogelijk uitgeschakeld voor je faciliteit, uitgesloten door de modelbeperking van de sleutel, of de provider heeft problemen.

Oplossing: controleer Settings → Models (is het model ingeschakeld?), de lijst Restrict models van de sleutel en Activity → Performance → Reliability & performance by model voor het foutpercentage van het model in de loop van de tijd.

Problemen met API-sleutels

401 Unauthorized

Oorzaak: met de code invalid_api_key ("Missing or invalid API key") ontbreekt de header Authorization: Bearer … of is deze onjuist opgemaakt. Zonder code ("Invalid API key") is de sleutel onbekend (verkeerd getypt, of een oud geheim na een rotate) of ingetrokken.

Oplossing: controleer de opmaak van de header en de status van de sleutel in Settings → Service Access & API Keys. Activeer een ingetrokken sleutel opnieuw, of werk je service bij met het nieuwe geheim als de sleutel is geroteerd.

Ik ben het geheim van de sleutel kwijt

Het geheim wordt alleen bij het aanmaken één keer getoond en kan niet worden hersteld. Gebruik Rotate: er wordt een nieuw geheim uitgegeven (één keer getoond) en de sleutel behoudt zijn label, limieten en geschiedenis. Werk elke service bij die de sleutel gebruikt: "You will need to reconfigure any services still using the old key."

De sleutel werkt, maar het gebruik staat onder de verkeerde naam

Sleutels worden in Activity en Logs herkend aan hun Label. Bewerk de sleutel en geef hem een betekenisvol label; geef elk systeem een eigen sleutel in plaats van er één te delen.

Problemen met agents

Een agent staat op Offline

Oorzaak: het apparaat staat uit of heeft geen verbinding. Dit gaat over de verbinding van het apparaat, niet over een instelling van Model Router.

Oplossing: controleer de stroomvoorziening en het netwerk van het apparaat. De toegangsconfiguratie blijft ongewijzigd en werkt weer zodra het apparaat opnieuw verbinding maakt.

Een agent reageert niet meer op AI-verzoeken

Controleer, in deze volgorde:

1. Saldo: een leeg saldo blokkeert alle agents (de agent toont een status waarin tegoed nodig is). Waardeer op.
2. Limieten per service: Settings → Service Access & API Keys → Connected Services: toont de agent "Limit reached"? Verhoog de limiet of wacht tot deze wordt teruggezet.
3. Accountlimieten: Budgets & Limits → Spend Limits.
4. Logs: filter op de agent om de werkelijke fout bij zijn verzoeken te zien.

Vragen over saldo en facturering

De bestedingscijfers lopen achter

De cijfers Available balance en Spent today zijn live. Monthly usage wordt elke 15 minuten met je saldo afgestemd, dus zeer recente uitgaven kunnen daar pas na een paar minuten verschijnen. De transactiegeschiedenis toont alleen opwaarderingen en saldocorrecties, dus gebruik verschijnt daar nooit.

Automatisch opwaarderen is niet uitgevoerd

Kijk op de pagina Balance & Top-up of er een melding staat: geen kaart geregistreerd, kaart vereist verificatie of kaart geweigerd. Los het kaartprobleem op (Update card / Edit payment details) of waardeer handmatig op. Controles voor automatisch opwaarderen worden ongeveer elke 15 minuten uitgevoerd, dus het kan een paar minuten duren voordat een zojuist overschreden drempel een opwaardering activeert.

Een opwaardering is mislukt

"Additional card authentication is required. Please try again.": probeer het opnieuw; je bank kan om verificatie vragen. "Top-up could not be completed.": de betaling is geweigerd; controleer de kaart of probeer een ander bedrag. Er wordt alleen tegoed bijgeschreven als de betaling slaagt.

Er is een bedrag afgeschreven, maar het saldo is niet veranderd

Opwaarderingen worden direct bijgeschreven, dus vernieuw de pagina. Als het saldo een geslaagde betaling nog steeds niet weergeeft, noteer dan de Transaction ID en Payment reference uit het detailvenster van de transactie (of van je kaartafschrift) en dien een ondersteuningsverzoek in.

Vragen over logs en analyses

Een verzoek dat ik net heb gedaan staat nog niet in de Logs

Schakel Live vernieuwen in (of klik op Refresh now). Verzoeken verschijnen normaal binnen enkele ogenblikken; bij hoge belasting kan het iets langer duren.

De logs tonen een model dat ik niet heb gevraagd

Als je model: "auto" hebt verzonden, tonen de logs het model waarnaar de Auto Router is omgezet. Open de details van het verzoek om Requested model: auto te zien. Dit is verwacht gedrag. Zie Modellen.

Rijen tonen "No charge"

Mislukte of lege antwoorden die niets kosten, krijgen het label No charge: ze worden voor de volledigheid vastgelegd, maar hebben geen saldo verbruikt.

Mijn CSV-export is kleiner dan verwacht

Ruwe exports zijn beperkt tot 25,000 rijen: verklein het datumbereik of gebruik een samenvattende export. Let ook op: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."