OpenRouter API key: poradnik

Klucz API OpenRouter: jak go uzyskać i korzystać z darmowych modeli

Utwórz klucz API OpenRouter, poznaj limity darmowych modeli, napraw błędy 401, 402 i 429 i używaj OpenRouter na iPhonie, Androidzie lub w przeglądarce.

Zaktualizowano
  • Aby uzyskać klucz API OpenRouter, zaloguj się na openrouter.ai, otwórz openrouter.ai/keys i utwórz klucz; zaczyna się on od „sk-or-v1-”. Utworzenie klucza nic nie kosztuje. Z modeli, których ID kończy się na „:free”, można korzystać w ramach dziennych limitów, a za każdy inny model płaci się z kredytów kupionych z góry.
  • OpenRouter to jedno konto i jeden klucz do modeli wielu firm AI. Nie wydaje własnej aplikacji czatu na iPhone’a ani Androida, więc na telefonie korzystasz z aplikacji, która przyjmuje klucz OpenRouter, takiej jak Oriveo.
  • Według stanu na 18 listopada 2026 r. darmowe modele pozwalają na 20 żądań na minutę i 50 dziennie albo 1000 dziennie po zakupie łącznie co najmniej 10 kredytów. Błąd 402 oznacza, że skończyły się kredyty.
Oriveo na iPhonie: ekran dostawców z listą podłączonych dostawców i wydatkami z tego miesiąca.

Czym jest OpenRouter i czym jest klucz API?

OpenRouter to usługa, która przez jedno konto daje dostęp do modeli wielu firm AI. Zamiast zakładać konto u każdej firmy osobno, raz doładowujesz kredyty w OpenRouter i wybierasz modele z jego listy.

Klucz API to tajny kod, którym aplikacja posługuje się, wysyłając żądania na twoje konto. OpenRouter sprawdza klucz, przekazuje wiadomość do wybranego modelu i pobiera koszt z twoich kredytów OpenRouter.

OpenRouter powstał z myślą o aplikacjach i deweloperach. Nie wydaje własnej aplikacji czatu na iPhone’a ani Androida i dlatego ludzie szukają „aplikacji OpenRouter”. Tak naprawdę potrzebują aplikacji czatu, która przyjmuje klucz OpenRouter.

Jak uzyskać klucz API OpenRouter?

Na stronie OpenRouter zajmuje to parę minut.

  • Wejdź na openrouter.ai i załóż konto albo się zaloguj.
  • Otwórz stronę kluczy openrouter.ai/keys i utwórz nowy klucz. Nadaj mu nazwę, po której poznasz, w jakiej aplikacji lub na jakim urządzeniu go używasz.
  • Skopiuj klucz. Klucze OpenRouter zaczynają się od „sk-or-v1-” i mają 73 znaki, więc sprawdź, czy skopiował się cały.
  • Jeśli chcesz korzystać z modeli, które nie są darmowe, dodaj kredyty na stronie „Credits”.
  • Przechowuj klucz w bezpiecznym miejscu, np. w menedżerze haseł. Jeśli wycieknie, usuń go na stronie kluczy i utwórz nowy.

Czy API OpenRouter jest za darmo?

Częściowo. Założenie konta i utworzenie klucza nic nie kosztuje, a OpenRouter oferuje darmowe modele, których ID kończy się na „:free”. Cała reszta jest opłacana z kredytów kupionych z góry. OpenRouter podaje też, że nowi użytkownicy dostają niewielką pulę darmowych kredytów, ale nie mówi, ile.

Darmowe modele mają limity. Oto limity opublikowane przez OpenRouter, według stanu na 18 listopada 2026 r.:

  • Jeśli saldo spadnie poniżej zera, według OpenRouter nawet darmowe modele mogą zwracać błędy.
  • Na stronie OpenRouter widać, które modele mają obecnie wersję „:free”; sprawdź to, zanim zaczniesz na którejś polegać.
Czy API OpenRouter jest za darmo?
Twoje kontoŻądania do darmowych modeli na minut꯹dania do darmowych modeli dziennie
Kupiono łącznie mniej niż 10 kredytów2050
Kupiono łącznie co najmniej 10 kredytów201000

Jak działają kredyty w OpenRouter?

OpenRouter działa na zasadzie przedpłaty. Kredyty kupujesz na stronie „Credits” kartą albo inną metodą płatności z tamtejszej listy, a każde żądanie jest od nich odliczane. Według stanu na 18 listopada 2026 r. regulamin OpenRouter określa minimalny zakup na 5 USD, przewiduje opłatę za obsługę płatności i zastrzega, że niewykorzystane kredyty mogą wygasnąć po 365 dniach od zakupu. Aktualne szczegóły znajdziesz na openrouter.ai/terms.

Każdy model ma własną cenę za token, podaną na jego stronie w OpenRouter. Nie przepisujemy tu cen, bo się zmieniają. Oriveo pokazuje szacunkowy koszt przy każdej odpowiedzi; wiążące są dane na stronach aktywności i rozliczeń w OpenRouter.

Jak używać OpenRouter na iPhonie, Androidzie lub w przeglądarce?

Oficjalnej aplikacji mobilnej OpenRouter nie ma, więc wybierasz aplikację kliencką. W Oriveo OpenRouter jest jednym z 15 wbudowanych dostawców, w grupie „Agregatory”, więc nie wpisujesz żadnego adresu.

  • Otwórz „Dostawcy”: na iPhonie i Androidzie to karta, a w wersji webowej pozycja w pasku bocznym.
  • Stuknij przycisk + („Dodaj dostawcę”) i wybierz OpenRouter. Filtr „Agregatory” zawęża listę.
  • Wklej klucz w sekcji „Połącz: OpenRouter” i stuknij „Kontynuuj”.
  • Poczekaj, aż minie etap „Weryfikowanie połączenia i synchronizowanie modeli...” (na Androidzie: „Sprawdzanie połączenia i synchronizowanie modeli…”). Oriveo wczytuje wtedy listę modeli OpenRouter.
  • Wybierz model i zacznij rozmowę. Jeśli nie masz kredytów, wybierz model, którego ID kończy się na „:free”.
Ekran główny Oriveo z polem wiadomości, wybranym modelem pod nim i dzisiejszymi czatami, każdy z kosztem
Po podłączeniu klucza wybierz model pod polem wiadomości. Przy każdym czacie na liście widać jego szacunkowy koszt.

Gdzie trafia mój klucz OpenRouter?

Na iPhonie i Androidzie żądania idą prosto z twojego urządzenia do dostawcy, a klucz jest trzymany w bezpiecznym magazynie telefonu (Keychain na iPhonie, Keystore na Androidzie). W wersji webowej żądania przechodzą przez serwer Oriveo, który przekazuje je na bieżąco: klucz jest używany tylko do danego żądania i nie jest zapisywany jako rekord konta, a czaty BYOK nie są przechowywane jako logi rozmów. Synchronizacja w chmurze nie przesyła kluczy. Aby używać OpenRouter na drugim urządzeniu, wklej klucz także tam albo utwórz dla tego urządzenia osobny klucz.

Płacisz OpenRouter bezpośrednio, według jego cen. Oriveo nie dolicza marży.

Dlaczego mój klucz API OpenRouter nie działa?

Strona błędów OpenRouter (openrouter.ai/docs/api-reference/errors) wyjaśnia znaczenie każdego kodu. Najczęstsze, według stanu na 18 listopada 2026 r.:

  • W Oriveo błąd 402 pojawia się jako „Osiągnięto limit dostawcy”, a 429 jako „Przekroczono limit żądań” w wersji webowej lub „Dostawca ograniczył liczbę żądań” na iPhonie i Androidzie.
  • Brakuje modelu na liście: zsynchronizuj listę modeli ponownie i sprawdź, czy OpenRouter nadal go oferuje.
Dlaczego mój klucz API OpenRouter nie działa?
BłądCo oznaczaCo zrobić
401 Invalid credentialsKlucz jest błędny, wyłączony lub usuniętySkopiuj jeszcze raz cały klucz albo utwórz nowy
401 „this is not an OpenRouter API key”Wklejono klucz innego dostawcyUżyj klucza z openrouter.ai/keys; zaczyna się od sk-or-v1-
402 insufficient creditsNa koncie lub na tym kluczu skończyły się kredytyDodaj kredyty albo podnieś limit klucza; czekanie nie pomoże
403 ForbiddenZablokowane przez uprawnienia, moderację, zabezpieczenie (guardrail) lub limit budżetuSprawdź ustawienia i limity klucza albo zmień treść wiadomości
429 rate limitedZa dużo żądań — dla OpenRouter albo dla dostawcy modeluOdczekaj i spróbuj ponownie; przy darmowych modelach sprawdź limity podane wyżej
502 lub 503Model albo jego dostawcy są w tej chwili niedostępniSpróbuj później albo wybierz inny model

OpenRouter czy klucz od każdego dostawcy?

OpenRouter jest wygodny, gdy chcesz mieć wiele modeli pod jednym kluczem i z jednym saldem. Klucz prosto od dostawcy, np. OpenAI lub Anthropic, pasuje wtedy, gdy chcesz mieć konto i rozliczenia bezpośrednio u tego dostawcy. Oriveo przyjmuje oba rodzaje, więc OpenRouter może stać obok bezpośrednich kluczy, a modele przełączasz jeden po drugim w tej samej rozmowie.

Najczęstsze pytania

Czy OpenRouter jest darmowy?
Częściowo. Klucz jest darmowy, a modele, których ID kończy się na „:free”, nic nie kosztują w ramach dziennych limitów: według stanu na 18 listopada 2026 r. to 50 żądań dziennie albo 1000 po zakupie łącznie co najmniej 10 kredytów. Inne modele wymagają kredytów kupionych z góry.
Gdzie uzyskać klucz API OpenRouter?
Na openrouter.ai/keys po zalogowaniu. Utwórz klucz, nadaj mu nazwę i skopiuj go w całości; zaczyna się od „sk-or-v1-”.
Czy OpenRouter ma aplikację na iPhone’a lub Androida?
OpenRouter nie wydaje własnej mobilnej aplikacji czatu. Skorzystaj z aplikacji, która przyjmuje klucz OpenRouter: w Oriveo otwórz „Dostawcy”, stuknij +, wybierz OpenRouter, wklej klucz i stuknij „Kontynuuj”.
Co oznacza błąd OpenRouter 402?
Na twoim koncie albo na używanym kluczu brakuje kredytów. Dodaj kredyty w OpenRouter lub podnieś limit klucza, jeśli jest ustawiony, i spróbuj ponownie. Samo z siebie to nie minie.
Dlaczego mój klucz API OpenRouter nie działa?
Sprawdź numer błędu. 401 oznacza, że klucz jest błędny albo nie jest kluczem OpenRouter; 402 — brak kredytów; 429 — za dużo żądań albo wyczerpany limit darmowych modeli. Każdy kod omawia nasz poradnik o błędach kluczy API.
Jak wygląda klucz API OpenRouter?
Zaczyna się od „sk-or-v1-”, a po tym przedrostku następują 64 litery i cyfry — razem 73 znaki. Jeśli twój jest krótszy, część się nie skopiowała.

Powiązane lektury

Używaj klucza OpenRouter na telefonie

Otwórz wersję webową albo pobierz Oriveo na iPhone’a lub Androida, wklej klucz OpenRouter i przełączaj modele z szacunkowym kosztem każdej odpowiedzi.

Nie masz jeszcze klucza API? Zacznij od Oriveo Free.