OpenRouter: jeden klucz do wszystkich modeli AI - przewodnik
Przewodnik po OpenRouter: konto i klucz z limitem, opłaty, darmowe modele, prywatność danych, przydatne pola w kodzie i test, jak wybór dostawcy zmienia cenę i szybkość tego samego modelu.

Spis treści 10
👁 455 przeczytań
- OpenRouter daje jeden klucz API i jedno saldo do kilkuset modeli AI, a ceny tokenów są takie same jak u producentów.
- Prowizja od doładowania wynosi 5,5% w planie Standard i 8% w planie Business, a 30 października 2026 w katalogu było 456 modeli, w tym 16 darmowych.
- W moim teście tego samego modelu u czterech dostawców najtańszy wariant był 5,6 razy tańszy od domyślnego, ale odpowiadał 6,2 sekundy.
OpenRouter to pośrednik, który daje jeden klucz API i jedno saldo do kilkuset modeli AI: OpenAI, Anthropic, Google, DeepSeek, Mistrala, Kimi i dziesiątek modeli otwartych. Za tokeny płacisz tyle samo co u producenta, a OpenRouter zarabia na prowizji od doładowania, w planie Standard 5,5%. Kod piszesz w bibliotece OpenAI i zmieniasz tylko adres serwera. Na OpenRouterze przetestowałem wszystkie skrypty ze ścieżki API AI od zera, więc niżej opisuję go z własnej pracy, a liczby z katalogu sprawdziłem ponownie 30 października 2026.
Co to jest OpenRouter i jak działa
OpenRouter sam nie trenuje ani nie uruchamia modeli. Przyjmuje zapytanie w formacie OpenAI (Chat Completions), sprawdza, którzy dostawcy obsługują wybrany model, i przekazuje je jednemu z nich. Przy modelach zamkniętych dostawca jest zwykle jeden albo kilku (Claude’a obsługuje Anthropic, a także Google Vertex i Amazon Bedrock). Przy otwartych bywa ich kilkadziesiąt: 30 października model gpt-oss-120b miał 25 dostawców, a GLM-5.3 aż 49.
W publicznym katalogu API było tego dnia 456 modeli, w tym 16 darmowych. Na stronie cennika OpenRouter pisze o ponad 600 modelach i ponad 80 dostawcach, bo liczy też warianty niewidoczne w podstawowej liście. Od sierpnia 2026 firma należy do Stripe, a transakcję za ponad 7 mld USD opisałem osobno.
Co z tego masz:
- Jeden klucz i jedno saldo zamiast pięciu kont z osobnymi kartami, limitami i fakturami.
- Zmiana modelu jednym napisem:
openai/gpt-6.1-solnaanthropic/claude-sonnet-5.5bez zmiany kodu. - Automatyczne przełączanie, gdy dostawca ma awarię.
- Koszt w każdej odpowiedzi: pole
usage.costw dolarach, co bardzo ułatwia liczenie.
Czego nie masz: umowy bezpośrednio z OpenAI czy Anthropic, części funkcji specyficznych dla jednego dostawcy (np. niektórych narzędzi serwerowych) i najwyższych limitów, które przychodzą po latach płacenia u źródła.
Jak zacząć: konto, klucz, limit
- Zaloguj się na openrouter.ai kontem Google, GitHub albo mailem.
- W Settings → Keys utwórz klucz (
sk-or-v1-...) i od razu ustaw Credit limit, np. 2 USD z odnowieniem miesięcznym. Limit może się odnawiać codziennie, co tydzień albo co miesiąc. - Jeśli chcesz płatnych modeli, doładuj konto w Settings → Credits. Na moim koncie 4 października doładowanie 10 USD kosztowało 10,80 USD, bo obowiązywało minimum prowizji 0,80 USD. Przy 20 USD wychodziło 21,10 USD.
- Zapisz klucz w pliku
.env(jak to zrobić bezpiecznie, opisuję w tekście Klucz API: jak go zdobyć i jak go nie spalić). - Uruchom pierwszy skrypt.
"""Pierwsze zapytanie do modelu AI przez OpenRouter (SDK openai)."""
import os
from dotenv import load_dotenv
from openai import OpenAI
load_dotenv() # wczytuje zmienne z pliku .env w bieżącym katalogu
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
odpowiedz = client.chat.completions.create(
model=os.getenv("MODEL", "openai/gpt-6-luna"),
messages=[
{"role": "system", "content": "Odpowiadasz po polsku, krótko i konkretnie."},
{"role": "user", "content": "Wyjaśnij w dwóch zdaniach, czym jest API."},
],
)
print(odpowiedz.choices[0].message.content)
print("---")
print("model:", odpowiedz.model)
print("tokeny wejścia:", odpowiedz.usage.prompt_tokens)
print("tokeny wyjścia:", odpowiedz.usage.completion_tokens)
szczegoly = odpowiedz.usage.completion_tokens_details
if szczegoly and szczegoly.reasoning_tokens:
print(" w tym tokeny myślenia:", szczegoly.reasoning_tokens)
koszt = getattr(odpowiedz.usage, "cost", None) # OpenRouter dokłada koszt w USD
if koszt is not None:
print(f"koszt: {koszt:.6f} USD")Wynik z mojego komputera:
API to zestaw reguł i narzędzi, dzięki którym różne programy mogą się ze sobą komunikować. Określa, jak wysyłać żądania i odbierać dane lub funkcje od innego systemu.
---
model: openai/gpt-6-luna
tokeny wejścia: 40
tokeny wyjścia: 58
koszt: 0.000033 USDStreaming, obsługę błędów i wersję z curl omawiam w tekście Pierwsze zapytanie do API AI w Pythonie.
Ile kosztuje OpenRouter
| Pozycja | Ile |
|---|---|
| Cena tokenów | jak u dostawcy, bez narzutu; przy modelach otwartych każdy dostawca ma własną stawkę |
| Prowizja od doładowania | 5,5% w planie Standard, 8% w planie Business; nie od pojedynczych zapytań |
| Własne klucze dostawców (BYOK) | bez opłaty do 25 000 USD miesięcznie po cenach katalogowych, potem 5% |
| Zwrot kredytów | tylko w ciągu 24 godzin od zakupu; prowizja i płatności kryptowalutą bez zwrotu |
| Ważność kredytów | OpenRouter zastrzega, że może je wygasić po roku |
| Zgoda na zapisywanie zapytań | 1% rabatu, domyślnie wyłączona |
Płacisz kartą, AliPay albo kryptowalutą USDC, zawsze w dolarach. Plan Enterprise ma ceny z umowy i faktury. Strona cennika z 30 października nie podaje już minimum prowizji, które pamiętam z doładowania na początku miesiąca, więc przy małych kwotach sprawdź podsumowanie przed zapłatą.
Nie przepłacaj za subskrypcje AI
Prowadzę sklep z rocznymi dostępami do narzędzi AI, taniej niż w cenniku producenta. Sprawdź, co jest teraz na stanie.
Jedna pułapka wraca regularnie: przy modelach otwartych karta modelu pokazuje jedną cenę, a zapytanie może trafić do dostawcy, który liczy kilka razy więcej. Sprawdziłem to na 15 modelach w tekście Cena na OpenRouter to nie cena, którą płacisz.
Mój test: ten sam model, czterech dostawców
Żeby pokazać, jak działa wybór dostawcy, 4 października wysłałem to samo pytanie do modelu gpt-oss-120b cztery razy, za każdym razem z innym ustawieniem pola provider:
"""OpenRouter: ten sam model u różnych dostawców. Kto obsłużył zapytanie, ile to trwało i ile kosztowało."""
import os, time
from dotenv import load_dotenv
from openai import OpenAI
load_dotenv()
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=os.environ["OPENROUTER_API_KEY"])
MODEL = "openai/gpt-oss-120b" # model otwarty, 4.10.2026 hostowało go 23 dostawców
PYTANIE = [{"role": "user", "content": "Napisz po polsku 3 zdania o tym, czym jest OpenRouter."}]
warianty = {
"domyślnie": {},
"najtaniej (sort=price)": {"provider": {"sort": "price"}},
"najszybciej (sort=throughput)": {"provider": {"sort": "throughput"}},
"bez zapisu danych (data_collection=deny, zdr)": {"provider": {"data_collection": "deny", "zdr": True}},
}
for nazwa, extra in warianty.items():
start = time.time()
r = client.chat.completions.create(model=MODEL, messages=PYTANIE, max_tokens=200, extra_body=extra)
czas = time.time() - start
dostawca = getattr(r, "provider", "?") # OpenRouter dokłada nazwę dostawcy do odpowiedzi
print(f"{nazwa:46} dostawca: {dostawca:12} {czas:4.1f} s "
f"{r.usage.completion_tokens:3} tokenów {r.usage.cost:.6f} USD")
domyślnie dostawca: SambaNova 1.0 s 178 tokenów 0.000181 USD
najtaniej (sort=price) dostawca: CoreWeave 6.2 s 175 tokenów 0.000032 USD
najszybciej (sort=throughput) dostawca: Cerebras 0.4 s 200 tokenów 0.000180 USD
bez zapisu danych (data_collection=deny, zdr) dostawca: Crusoe 0.8 s 152 tokenów 0.000042 USD- Domyślnie zapytanie trafiło do SambaNovy: szybko (1,0 s), ale za 0,000181 USD.
- Sortowanie po cenie wybrało CoreWeave: 5,6 razy taniej, za to odpowiedź trwała 6,2 s.
- Sortowanie po przepustowości wybrało Cerebras: 0,4 s, cena jak domyślnie.
- Bez zapisu danych zapytanie poszło do Crusoe: 0,8 s i tylko o 30% drożej niż najtańszy wariant.
Przy jednym zapytaniu to ułamki centa. Przy automacie, który wysyła 10 tysięcy zapytań dziennie, różnica między wariantem domyślnym a sortowaniem po cenie to kilkadziesiąt dolarów miesięcznie. Dlatego w kodzie produkcyjnym zawsze ustawiam pole provider świadomie. Skróty działają też w nazwie modelu: :floor sortuje po cenie, :nitro po szybkości (np. openai/gpt-oss-120b:nitro).
Darmowe modele
Modele z dopiskiem :free kosztują 0 USD i nie wymagają doładowania. Listę pobierzesz bez klucza, a mój skrypt od razu testuje jeden z nich:
"""Lista darmowych modeli w OpenRouter (lista modeli nie wymaga klucza) i test jednego z nich."""
import os, sys, json, urllib.request
from dotenv import load_dotenv
from openai import OpenAI
with urllib.request.urlopen("https://openrouter.ai/api/v1/models") as f:
modele = json.load(f)["data"]
darmowe = [m for m in modele if m["id"].endswith(":free")]
print(f"Wszystkich modeli: {len(modele)}, darmowych: {len(darmowe)}\n")
for m in sorted(darmowe, key=lambda m: -m["context_length"]):
print(f"{m['id']:52} kontekst {m['context_length']:>9}")
load_dotenv()
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=os.environ["OPENROUTER_API_KEY"])
model = sys.argv[1] if len(sys.argv) > 1 else "google/gemma-4-31b-it:free"
r = client.chat.completions.create(model=model, messages=[{"role": "user", "content": "Napisz po polsku jedno zdanie o jesieni."}])
print(f"\n{model}: {r.choices[0].message.content.strip()}")
print(f"koszt: {r.usage.cost} USD")Tak wyglądał wynik 4 października:
Wszystkich modeli: 466, darmowych: 17
thinkingmachines/inkling-small:free kontekst 1048576
thinkingmachines/inkling:free kontekst 1048576
nvidia/nemotron-3.5-lightning:free kontekst 1000000
nvidia/nemotron-3-ultra-550b-a55b:free kontekst 1000000
dots-studio/dots-3-note-preview:free kontekst 512000
apodex/apodex-1.1-mini:free kontekst 262144
inclusionai/ling-3.0-flash-sante:free kontekst 262144
qwen/qwen3.8-27b:free kontekst 262144
poolside/laguna-s-2.1:free kontekst 262144
poolside/laguna-xs-2.1:free kontekst 262144
google/gemma-4-26b-a4b-it:free kontekst 262144
google/gemma-4-31b-it:free kontekst 262144
nvidia/nemotron-3-super-120b-a12b:free kontekst 262144
cohere/north-mini-code:free kontekst 256000
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free kontekst 256000
nvidia/nemotron-3.5-content-safety:free kontekst 128000
liquid/lfm-2.5-2.6b:free kontekst 65536
google/gemma-4-31b-it:free: Jesień to czas, kiedy liście mienią się złotem i czerwienią, a powietrze staje się rześkie i chłodne.
koszt: 0 USDLista żyje własnym życiem. 30 października darmowych modeli było 16: zniknęły m.in. Qwen3.8 27B, Apodex 1.1 Mini i Ling 3.0 Flash, a doszły Nemotron 3.5 Super VL, Flint 1.0 i Xing 4.0. Gemma 4 31B, którą testowałem, nadal jest za darmo.
Ograniczenia:
- Limity: 20 zapytań na minutę i 50 dziennie łącznie dla wszystkich darmowych modeli. Po zakupie co najmniej 10 USD kredytów (kiedykolwiek) limit rośnie do 1000 dziennie. Nieudane próby też się liczą, a ujemne saldo blokuje darmowe modele.
- Dostępność: darmowe warianty bywają przeciążone (błąd 429) i znikają z katalogu bez zapowiedzi.
- Prywatność: część darmowych endpointów działa dopiero po zgodzie na trenowanie na twoich danych. Do danych klientów darmowych modeli nie używam.
- Polszczyzna: Gemma 4 31B odpowiedziała poprawnie, ale małe modele (np. 2,6B) radzą sobie z polskim słabo.
Prywatność i dane
Według FAQ OpenRouter domyślnie nie zapisuje treści zapytań ani odpowiedzi, tylko metadane: czas, model, liczbę tokenów. Treść trafia jednak do dostawcy modelu i to jego zasady decydują, co się z nią dzieje. Masz na to trzy przełączniki:
- ustawienia prywatności konta, czyli czy dopuszczasz dostawców, którzy mogą trenować na danych,
"data_collection": "deny"w poluprovider, czyli tylko dostawcy, którzy nie przechowują danych,"zdr": true, czyli tylko endpointy z zerowym przechowywaniem danych (Zero Data Retention).
Do danych osobowych i firmowych potrzebujesz i tak umowy powierzenia przetwarzania. OpenRouter to dodatkowy podmiot w łańcuchu, więc przy RODO sprawdź, czy jego warunki ci wystarczą, albo idź bezpośrednio do dostawcy.
Przydatne pola w kodzie
Lista zapasowych modeli: gdy pierwszy nie odpowie, OpenRouter sam spróbuje kolejnego. Składnię sprawdziłem 4 października, wtedy z Haiku 4.5 (zapytanie obsłużył pierwszy model z listy), awarii nie symulowałem:
r = client.chat.completions.create(
model="anthropic/claude-haiku-5.5",
messages=[{"role": "user", "content": "Powiedz OK."}],
extra_body={"models": ["anthropic/claude-haiku-5.5", "openai/gpt-6-luna", "google/gemini-3.8-flash"]},
)
print(r.model) # który model faktycznie odpowiedziałInne pola, których używam:
"provider": {"require_parameters": true}- tylko dostawcy, którzy obsługują wszystkie parametry zapytania. Bez tego OpenRouter po cichu pomija nieobsługiwane, np. temperaturę w GPT-6 (sprawdzałem to przy parametrach API)."provider": {"order": ["Cerebras"], "allow_fallbacks": false}- tylko wskazany dostawca."provider": {"max_price": {"completion": 1.0}}- górna granica stawki za milion tokenów wyjścia.- Aliasy z tyldą, np.
~anthropic/claude-sonnet-latest- zawsze najnowsza wersja z rodziny. W produkcji wolę stałą nazwę, żeby model nie zmienił się bez mojej wiedzy.
OpenRouter czy bezpośrednio u dostawcy
| OpenRouter | Bezpośrednio | |
|---|---|---|
| Modele | kilkaset na jednym kluczu | tylko modele danej firmy |
| Cena tokenów | taka sama | taka sama |
| Dodatkowy koszt | 5,5% od doładowania (Standard) | brak |
| Darmowy start | 16 modeli :free, 50 zapytań dziennie | zależy od firmy, część go nie ma |
| Nowe funkcje | czasem z opóźnieniem | od pierwszego dnia |
| Umowa i faktura | z OpenRouter | z producentem |
Moja zasada: OpenRouter do nauki, prototypów i porównywania modeli, bezpośrednio u producenta, gdy produkcja stoi na jednym modelu, a znaczenie ma każdy procent kosztu albo umowa. Bez opłat za tokeny, na własnym komputerze, działa Ollama.
Najczęstsze pytania
Co to jest OpenRouter?
Serwis, który pod jednym kluczem API i jednym saldem udostępnia modele wielu firm, od GPT i Claude’a po modele otwarte. Sam modeli nie uruchamia, tylko przekazuje zapytanie do wybranego dostawcy.
Czy OpenRouter jest darmowy?
Konto i klucz są darmowe, modele z dopiskiem :free też (50 zapytań dziennie, 1000 po zakupie co najmniej 10 USD kredytów). Za pozostałe płacisz z doładowanego salda, a przy doładowaniu prowizję.
Czy OpenRouter jest droższy niż API OpenAI?
Ceny tokenów są te same. Dopłacasz prowizję przy doładowaniu: w planie Standard 5,5%, czyli przy 100 USD około 5,50 USD.
Czy OpenRouter jest bezpieczny?
To duża firma (od sierpnia 2026 część Stripe) i według FAQ domyślnie nie zapisuje treści zapytań. Ryzyko leży raczej u dostawców modeli i w wycieku klucza, dlatego ustaw limit na kluczu i wybierz dostawców bez przechowywania danych.
Czy mogę płacić w złotówkach?
Nie, rozliczenia są w dolarach. Karta przeliczy kwotę po kursie twojego banku.
Co znaczy błąd 402?
Brak środków na koncie albo wyczerpany limit klucza. Doładuj saldo albo podnieś Credit limit w ustawieniach klucza. Stan sprawdzisz zapytaniem GET na https://openrouter.ai/api/v1/key (dany klucz) albo /api/v1/credits (całe konto).
Źródła
- OpenRouter: cennik - plany Free, Standard, Business, Enterprise, prowizje 5,5% i 8%, BYOK (dostęp 30.10.2026)
- OpenRouter: FAQ - zwroty, wygasanie kredytów, limity darmowych modeli, prywatność, rabat 1% (dostęp 30.10.2026)
- OpenRouter: katalog modeli (API) - 456 modeli, 16 darmowych (dostęp 30.10.2026)
- OpenRouter: wybór dostawcy (dostęp 4.10.2026)
- OpenRouter: warianty modeli :free, :nitro, :floor (dostęp 4.10.2026)
- OpenRouter: Quickstart (dostęp 4.10.2026)
- Testy: moje skrypty z 4.10.2026, Windows 11, Python 3.13.15, openai 3.24.0, łączny koszt poniżej 0,001 USD
Sprawdzone: 30.10.2026
Link do Kimi jest partnerski: jeśli kupisz przez niego, serwis dostaje prowizję, a Ty płacisz tyle samo. Nie wpływa to na treść, także tam, gdzie piszę krytycznie.

Autor
Twórca i autor Promptowego, polskiego serwisu o sztucznej inteligencji. Codziennie śledzi premiery modeli, narzędzia i regulacje AI, i tłumaczy je prostym, konkretnym językiem.
Czytaj dalej
Artykuły · Jeden sensor zamiast dwóch. Nowy lidar widzi kolory i odległość narazPierwszy masowo produkowany kolorowy lidar firmy Ouster rejestruje odległość i barwę w jednym układzie scalonym. Jak działa sensor widzący 20...
Newsy · Wojsko USA wybierało cele z pomocą AI, ale przeoczyło notatkę, że jeden z nich to szkołaŚledztwo w sprawie ataku rakietowego na irańską szkołę, w którym zginęło około 120 dzieci, ujawniło poważne luki w systemach wyznaczania celów armii...
Artykuły · Dzieci czytają intencje z ludzkich oczu. Z robotycznym spojrzeniem mają kłopotDzieci bezbłędnie odczytują intencje z ludzkiego wzroku, ale gubią się, gdy patrzy na nie robot. Nowe badania pokazują, że sama imitacja gestu nie...- przelomowy.plAlphaGenome 2 od DeepMind: model przewiduje, w jakich komórkach działa wariant DNA
- generatornia.plŻyczenia świąteczne obrazek: jak zrobić kartkę AI na komunikatory
- przewagi.plAutomatyzacja faktur: zacznij od obiegu i wyjątków, potem dodaj AI
- jutropis.plKE konsultuje formularz oceny wpływu AI na prawa podstawowe



