Kategoria: Formularze i API

OpenRouter API zwraca 401 Unauthorized — co sprawdzić?

Poradnik techniczny · Kacper Bernecki

Czat na stronie pokazuje błąd zamiast odpowiedzi, a endpoint OpenRouter zwraca 401 Unauthorized.

Dlaczego problem występuje?

Zwykle problem dotyczy klucza, formatu nagłówka Authorization, uprawnienia albo błędnego środowiska, z którego klucz jest odczytywany.

Diagnostyka i rozwiązanie

1. Sprawdź w logach status odpowiedzi i identyfikator żądania bez drukowania klucza API.

2. Zweryfikuj, czy kod serwera korzysta z odpowiedniej zmiennej środowiskowej.

3. Upewnij się, że nagłówek ma wymagany format Bearer i nie zawiera przypadkowych spacji.

4. Sprawdź w panelu dostawcy stan klucza i ewentualne ograniczenia.

5. Po rotacji klucza wykonaj nowy deploy lub restart zgodnie z platformą i test na krótkim pytaniu.

Jak sprawdzić i czego unikać?

Serwer otrzymuje poprawną odpowiedź z API, a klucz nie pojawia się w HTML, konsoli ani repozytorium.

Nigdy nie wysyłaj sekretnego klucza z przeglądarki przez NEXT_PUBLIC lub kod klientowy.