Rozwiązywanie problemów

Przejdź do objawu, który odpowiada temu, co widzisz. Niemal zawsze najszybszym narzędziem diagnostycznym jest karta Logs — pokazuje status każdego żądania i wzorzec błędów (jeden klucz? jeden model? wszystko?). Zobacz Aktywność i dzienniki.

Żądania są blokowane

Każde żądanie kończy się błędem 402 insufficient_credits

Przyczyna: moduł nie jest włączony dla tego obiektu albo saldo przedpłacone zostało wyczerpane (karta Overview wyświetli komunikat "Your balance is depleted. Inference requests will be blocked until you top up."). W przypadku kluczy API obiekt, w którym Model Router nie jest włączony, zwraca zamiast tego błąd 403 "Model Router is not enabled for this facility".

Rozwiązanie: włącz Model Router na stronie Welcome to Model Router (zobacz Pierwsze kroki), a następnie doładuj saldo w obszarze Budgets & Limits → Balance & Top-up. Żądania zostaną wznowione chwilę po zaksięgowaniu salda. Aby zapobiec ponownemu wystąpieniu problemu, włącz automatyczne doładowanie. Zobacz Budżety i doładowania.

Żądania kończą się błędem 402 budget_exceeded

Przyczyna: osiągnięto limit wydatków. Komunikat o błędzie wskazuje, którego okresu dotyczy (dzienny / miesięczny / całkowity) oraz — w przypadku limitów dziennych i miesięcznych — dokładnie, kiedy zostanie zresetowany w strefie czasowej obiektu. Może to być limit dla całego konta albo limit konkretnego klucza lub połączonej usługi (gdy limit ma zawężony zakres, komunikat zawiera "This key's" / "This agent's").

Rozwiązanie: poczekaj na wskazany reset, podnieś limit (Budgets & Limits → Spend Limits albo konfiguracja klucza lub usługi) lub — w przypadku sztywnego limitu całkowitego — użyj opcji Reset hard cap. Strona Spend Limits pokazuje dokładnie, które limity mają status "Limit reached".

Żądania kończą się błędem 403 content_policy_violation

Przyczyna: prompt pasował do filtra treści w trybie block lub do ochrony przed wstrzykiwaniem promptów.

Rozwiązanie: sprawdź Settings → Guardrails. Jeśli jedna integracja rzeczywiście potrzebuje innych reguł, użyj jej przełącznika Override facility guardrails zamiast łagodzić zasady obowiązujące w całym obiekcie. Zobacz Zabezpieczenia.

Żądania kończą się błędem 429

Przyczyna: klucz lub połączona usługa przekroczyły swój limit szybkości Requests / min lub Tokens / min.

Rozwiązanie: odczekaj i ponów próbę albo podnieś limity szybkości w konfiguracji klucza lub usługi (puste pole = bez limitu). Zobacz Klucze API.

Jeden model zwraca błędy, a pozostałe działają

Przyczyna: model może być wyłączony dla obiektu, wykluczony przez ograniczenie modeli w kluczu albo dostawca może mieć problemy.

Rozwiązanie: sprawdź Settings → Models (czy model jest włączony?), listę Restrict models w kluczu oraz Activity → Performance → Reliability & performance by model, aby zobaczyć współczynnik błędów modelu w czasie.

Problemy z kluczami API

401 Unauthorized

Przyczyna: przy kodzie invalid_api_key ("Missing or invalid API key") brakuje nagłówka Authorization: Bearer … lub ma on nieprawidłowy format. Bez kodu ("Invalid API key") klucz jest nieznany (literówka albo stary sekret po operacji rotate) lub został revoked.

Rozwiązanie: sprawdź format nagłówka oraz status klucza w Settings → Service Access & API Keys. Ponownie aktywuj unieważniony klucz albo zaktualizuj usługę, wprowadzając nowy sekret, jeśli klucz został zrotowany.

Zgubiony sekret klucza

Sekret jest wyświetlany tylko raz, podczas tworzenia, i nie można go odzyskać. Użyj opcji Rotate — zostanie wydany nowy sekret (wyświetlany jeden raz), a klucz zachowa etykietę, limity i historię. Zaktualizuj każdą usługę, która używa tego klucza: "You will need to reconfigure any services still using the old key."

Klucz działa, ale użycie jest widoczne pod niewłaściwą nazwą

W obszarach Activity i Logs klucze są identyfikowane po polu Label. Edytuj klucz i ustaw opisową etykietę; każdemu systemowi przydziel osobny klucz zamiast współdzielić jeden.

Problemy z agentami

Agent ma status Offline

Przyczyna: urządzenie jest wyłączone lub nie ma łączności — dotyczy to łączności urządzenia, a nie ustawień Model Router.

Rozwiązanie: sprawdź zasilanie i sieć urządzenia. Jego konfiguracja dostępu pozostaje nienaruszona i zacznie znowu działać, gdy tylko urządzenie ponownie się połączy.

Agent przestał odpowiadać na żądania AI

Sprawdź po kolei:

1. Saldo — wyczerpane saldo blokuje wszystkich agentów (agent wyświetla stan wymagający środków). Doładuj saldo.
2. Limity usługi — Settings → Service Access & API Keys → Connected Services: czy agent ma status "Limit reached"? Podnieś limit lub poczekaj na jego reset.
3. Limity konta — Budgets & Limits → Spend Limits.
4. Dzienniki — przefiltruj według agenta, aby zobaczyć rzeczywisty błąd w jego żądaniach.

Pytania o saldo i rozliczenia

Kwoty wydatków wydają się opóźnione

Wartości Available balance i Spent today są aktualizowane na bieżąco. Wartość Monthly usage jest uzgadniana z saldem co 15 minut, więc pojawienie się w niej najnowszych wydatków może potrwać kilka minut. Historia transakcji zawiera tylko doładowania i korekty salda, więc użycie nigdy się w niej nie pojawia.

Automatyczne doładowanie nie zostało wykonane

Sprawdź, czy na stronie Balance & Top-up jest wyświetlany baner: brak zapisanej karty, karta wymaga uwierzytelnienia lub karta została odrzucona. Popraw dane karty (Update card / Edit payment details) lub doładuj saldo ręcznie. Automatyczne doładowanie jest sprawdzane mniej więcej co 15 minut, więc uruchomienie po przekroczeniu progu może potrwać kilka minut.

Doładowanie nie powiodło się

"Additional card authentication is required. Please try again." — ponów próbę; bank może poprosić o weryfikację. "Top-up could not be completed." — obciążenie zostało odrzucone; sprawdź kartę lub spróbuj innej kwoty. Środki są zaksięgowywane tylko wtedy, gdy obciążenie się powiedzie.

Karta została obciążona, ale saldo się nie zmieniło

Doładowania są księgowane natychmiast — odśwież stronę. Jeśli saldo nadal nie odzwierciedla udanego obciążenia, zanotuj wartości Transaction ID i Payment reference z panelu szczegółów transakcji (lub z wyciągu z karty) i zgłoś prośbę o wsparcie.

Pytania o dzienniki i analizy

Właśnie wysłanego żądania nie ma jeszcze w dziennikach

Włącz odświeżanie Live (lub kliknij Refresh now). Żądania zwykle pojawiają się po chwili; przy dużym obciążeniu może to potrwać nieco dłużej.

Dzienniki pokazują model, którego nie wybrano

Jeśli wysłano model: "auto", dzienniki pokazują model, który wybrał Auto Router — otwórz szczegóły żądania, aby zobaczyć Requested model: auto. Jest to oczekiwane zachowanie. Zobacz Modele.

Wiersze mają oznaczenie „No charge”

Nieudane lub puste odpowiedzi, które nic nie kosztowały, mają oznaczenie No charge — są rejestrowane dla kompletności, ale nie zużyły salda.

Eksport CSV jest mniejszy niż oczekiwano

Eksporty surowych danych są ograniczone do 25 000 wierszy — zawęź zakres dat lub użyj eksportu podsumowania. Uwaga: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."