Przejdź do treści
Sklep

Artykuły

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.

Tekst: 10 min czytania
OpenRouter: jeden klucz do wszystkich modeli AI - przewodnik
Spis treści 10
  1. Co to jest OpenRouter i jak działa
  2. Jak zacząć: konto, klucz, limit
  3. Ile kosztuje OpenRouter
  4. Mój test: ten sam model, czterech dostawców
  5. Darmowe modele
  6. Prywatność i dane
  7. Przydatne pola w kodzie
  8. OpenRouter czy bezpośrednio u dostawcy
  9. Najczęstsze pytania
  10. Źródła

👁 455 przeczytań

w skrócie
  • 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-sol na anthropic/claude-sonnet-5.5 bez zmiany kodu.
  • Automatyczne przełączanie, gdy dostawca ma awarię.
  • Koszt w każdej odpowiedzi: pole usage.cost w 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

  1. Zaloguj się na openrouter.ai kontem Google, GitHub albo mailem.
  2. 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.
  3. 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.
  4. Zapisz klucz w pliku .env (jak to zrobić bezpiecznie, opisuję w tekście Klucz API: jak go zdobyć i jak go nie spalić).
  5. 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 USD

Streaming, obsługę błędów i wersję z curl omawiam w tekście Pierwsze zapytanie do API AI w Pythonie.

Ile kosztuje OpenRouter

PozycjaIle
Cena tokenówjak u dostawcy, bez narzutu; przy modelach otwartych każdy dostawca ma własną stawkę
Prowizja od doładowania5,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ówtylko w ciągu 24 godzin od zakupu; prowizja i płatności kryptowalutą bez zwrotu
Ważność kredytówOpenRouter 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.

Zobacz, co jest dostępne

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 USD

Lista ż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 polu provider, 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

OpenRouterBezpośrednio
Modelekilkaset na jednym kluczutylko modele danej firmy
Cena tokenówtaka samataka sama
Dodatkowy koszt5,5% od doładowania (Standard)brak
Darmowy start16 modeli :free, 50 zapytań dzienniezależy od firmy, część go nie ma
Nowe funkcjeczasem z opóźnieniemod pierwszego dnia
Umowa i fakturaz OpenRouterz 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

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.

Piotr Olszewski

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.

O mnie →Wszystkie teksty →

Czytaj dalej

Narzędzia do tego tematu

darmowe, bez kontaWszystkie 29 →
z sieci - nowe teksty w moich serwisach

Wszystkie moje projekty →

Najczęściej czytane

7 dni
  1. 1GPT-6.2 Astra vs Claude Fable 5.2 vs Gemini 4 Carbon: benchmarki i mój test na 7 modelach (z Opus 5.5)
  2. 2Plakat festiwalu z polskim napisem: prompt i test 6 generatorów obrazu (Prompt dnia 14.11)
  3. 330 promptów do ChatGPT Images i 10 do przerabiania zdjęć
🛒 Sklep Kinetyka CapCut Pro 460 zł/rok Lovable Pro 450 zł/rok Replit Core 119 zł/rok Zobacz wszystko →