API AI od zera: jak działa, klucze, koszty i pierwsze zapytanie

👁 118 przeczytań

API AI to dostęp do modeli takich jak GPT, Claude i Gemini z poziomu programu, a nie okienka czatu. Wysyłasz zapytanie z kluczem, dostajesz odpowiedź w JSON i płacisz za zużyte tokeny, zwykle ułamki centa za zapytanie. To pierwszy etap ścieżki od zera do własnego agenta AI: poniżej znajdziesz mapę całej drogi, kolejne kroki z tekstami, aktualne ceny i paczkę gotowych skryptów, które sam uruchomiłem na Windowsie.

Mapa ścieżki: od zera do własnego agenta

Czytelnik zapytał mnie, gdzie znaleźć wyjaśnienie krok po kroku, jak działa API, jak robić automatyzacje i jak zbudować prostego agenta, tak żeby nie tylko skopiować kod, ale rozumieć, co się dzieje. Po polsku takiej ścieżki nie znalazłem, więc ją buduję. Ma trzy etapy, każdy opiera się na poprzednim:

Etapy 2 i 3 zbiera osobny przewodnik Agenci AI od zera (wkrótce). Teoria w tle: LLM: jak działa duży model językowy, MCP, RAG i fine tuning.

Co to jest API AI

API (Application Programming Interface) to ustalony sposób, w jaki jeden program zamawia coś u drugiego. W przypadku AI Twój program wysyła przez internet zapytanie z modelem, wiadomościami i parametrami, a serwer dostawcy odsyła wygenerowany tekst. Bez okienka czatu, bez historii rozmów, bez abonamentu - płacisz za liczbę tokenów, czyli kawałków tekstu na wejściu i wyjściu.

Prawdziwe zapytanie, które wysłałem 4 października 2026 z terminala na Windowsie, wygląda tak:

#!/usr/bin/env bash
# Pierwsze zapytanie przez curl (Git Bash, Linux, macOS). Wcześniej: export OPENROUTER_API_KEY=sk-or-v1-...
curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna",
    "messages": [{"role": "user", "content": "Napisz jedno zdanie o Krakowie."}]
  }'

Model GPT-6 Luna odpowiedział jednym zdaniem o Krakowie, zużył 16 tokenów wejścia i 36 wyjścia, a OpenRouter policzył za to 0,0000196 USD. Pełne wyjaśnienie zapytania, odpowiedzi, JSON-a i kodów błędów (401, 429, 500) jest w tekście Co to jest API? Wyjaśnienie na przykładzie AI.

Do czego się to przydaje w praktyce:

• streszczanie maili, notatek i dokumentów w tle, bez kopiowania do czatu;
• wyciąganie danych z faktur, CV, ogłoszeń prosto do arkusza;
• chatbot na stronie albo w komunikatorze;
• klasyfikacja zgłoszeń i opinii klientów;
• automaty, które działają w nocy i co rano zostawiają gotowy raport;
• agenci, którzy sami wywołują narzędzia - to etap 3 ścieżki.

Jak zacząć: krok po kroku

1. Zrozum zapytanie i odpowiedź. 15 minut z tekstem Co to jest API i pierwszy curl bez programowania.
2. Załóż konto i klucz. Na start polecam OpenRouter (jeden klucz do wszystkich modeli) albo Google AI Studio (darmowo, bez karty). Instrukcja dla czterech dostawców i zasady bezpieczeństwa: Klucz API: jak go zdobyć i jak go nie spalić.
3. Ustaw limit wydatków na kluczu. 2-5 USD miesięcznie wystarczy na naukę. To jedyne zabezpieczenie, które naprawdę działa, gdy klucz wycieknie.
4. Zainstaluj Pythona i wyślij pierwsze zapytanie. Venv, biblioteka openai, streaming, obsługa błędów i ponawianie: Pierwsze zapytanie do API AI w Pythonie. Jest też wersja w Node.js.
5. Policz, ile to kosztuje. Tokeny AI i kalkulator kosztu API.
6. Naucz się parametrów. System prompt, temperatura, okno kontekstowe i max tokens z eksperymentem: Parametry API po ludzku.
7. Odbieraj dane, nie tekst. Structured output: jak zmusić AI do odpowiedzi w JSON - bez tego nie zbudujesz automatyzacji.
8. Wybierz dostawcę na dłużej. OpenAI, Claude czy Gemini API - porównanie i przewodnik po OpenRouter.

Modele i dostawcy

Każda firma ma rodzinę modeli od tanich i szybkich po drogie i najmocniejsze. Na początek wystarczy znać po jednym z każdej półki:

Szczegóły dostawców opisałem osobno: Google AI Studio, DeepSeek, Mistral, Kimi, Grok API i Agents API od OpenAI.

Ceny API

W API płacisz za milion tokenów, osobno za wejście i wyjście. Ceny z 4 października 2026, w USD, bez VAT:

* Streszczenie maila: 800 tokenów wejścia i 150 wyjścia, 100 razy dziennie przez 30 dni. Pełną tabelę 20 modeli ze źródłami i interaktywny kalkulator, w którym wpiszeszsz własne liczby, znajdziesz w tekście Tokeny AI: co to jest i ile kosztują. Dwie rzeczy, które cennik ukrywa: modele rozumujące doliczają „myślenie” do tokenów wyjścia (Gemini 3.8 Flash zużył u mnie 390 tokenów myślenia na dwa zdania odpowiedzi), a polski tekst zajmuje więcej tokenów niż angielski.

API AI po polsku

Wszystkie modele dużych firm rozumieją i piszą po polsku. W moim teście sześciu modeli na tym samym pytaniu każdy odpowiedział poprawną polszczyzną, różnice były w stylu i dyscyplinie formatu. Polski ma za to swoją cenę w tokenach. Ten sam akapit wysłałem do siedmiu modeli po polsku i po angielsku:

Wniosek praktyczny: przy polskich tekstach porównuj modele po realnym koszcie zapytania (pole usage.cost), a nie po stawce z cennika. Claude Sonnet 5.5 i GPT-6.1 Sol mają identyczny cennik, ale ten sam polski tekst w Claude to około 1,7 raza więcej tokenów. Metoda pomiaru i skrypt są w tekście o tokenach. Dokumentacja wszystkich dostawców jest po angielsku; po polsku masz tę ścieżkę.

Mój test: paczka promptowy-api-starter

Każdy fragment kodu z tej ścieżki uruchomiłem na swoim komputerze i w tekstach pokazuję prawdziwy wynik, a nie to, co „powinno” wyjść. Środowisko: Windows 11 Pro, Python 3.13.15 (biblioteki openai 3.24.0, pydantic 2.13.5, tiktoken 0.14.0), Node.js 26.10 (openai 7.27.0), curl 8.22. Dostęp do modeli przez OpenRouter. Wszystkie skrypty zebrałem w jedną paczkę z polskim README i plikiem .env.example bez kluczy:

Pobierz gotowe skrypty: promptowy-api-starter.zip

W środku:

• 01-03 - pierwsze zapytanie z licznikiem kosztu, streaming, obsługa błędów z ponawianiem i udawany serwer zwracający 429 do testów za 0 zł;
• 04 - eksperyment z temperaturą 0 / 0,7 / 1,2 i pułapka z GPT-6, który po cichu ignoruje temperaturę;
• 05 - structured output: dane z faktury ze schematem Pydantic i analiza opinii klientów;
• 06 - podział tekstu na tokeny i pomiar „podatku od polszczyzny” na 7 modelach;
• 07 - system prompt i ucinanie odpowiedzi przez max_tokens;
• 08 - lista darmowych modeli OpenRouter;
• 09 - to samo pytanie do 6 modeli z czasem i kosztem;
• 10 - ten sam model u różnych dostawców: najtaniej, najszybciej, bez zapisu danych;
• curl/, js/, dostawcy/ - zapytania z terminala, wersja Node.js i kod bezpośrednio pod OpenAI, Anthropic i Gemini.

Uczciwie o ograniczeniach: skryptów z katalogu dostawcy/ nie uruchamiałem z prawdziwymi kluczami OpenAI, Anthropic i Google, tylko z fałszywymi (serwery odpowiedziały błędem autoryzacji, więc biblioteki i kod działają). Wszystko inne przeszło przez prawdziwe modele. Łączny koszt wszystkich uruchomień w tej ścieżce wyniósł około 5 centów.

Najciekawsze wyniki z testów:

• przy temperaturze 0 model trzy razy dał identyczną odpowiedź co do znaku, przy 1,2 wymyślił słowo „Mrugu” i złamał linię w środku nazwy;
• to samo pytanie do sześciu modeli kosztowało od 0,00002 do 0,00313 USD - 150 razy różnicy przy podobnej jakości;
• ten sam model gpt-oss-120b u czterech dostawców: od 0,4 s do 6,2 s i do 5,6 raza różnicy w cenie;
• prośba „odpowiedz w JSON” bez schematu zwróciła JSON owinięty w blok Markdown, na którym json.loads się wywrócił.

API, czat, model lokalny czy narzędzie no-code

Kiedy model na własnej karcie wychodzi taniej niż API, policzyłem w tekście Lokalny model czy API. Narzędzia no-code to etap 2 ścieżki - pod spodem i tak wysyłają zapytania do API, więc wiedza z tego etapu się przyda.

Dla kogo jest ta ścieżka

• Dla osób, które używają czatów AI i chcą więcej - automatyzacji powtarzalnych zadań bez ręcznego kopiowania.
• Dla programistów spoza AI - szybkie wejście w specyfikę modeli: tokeny, parametry, koszty, structured output.
• Dla właścicieli małych firm - żeby policzyć, ile naprawdę kosztowałby chatbot albo automat, zanim zapłacisz agencji.
• Dla uczniów i studentów - wszystko da się przećwiczyć za darmo na darmowych modelach.

Nie potrzebujesz doświadczenia w programowaniu. Wystarczy umieć skopiować polecenie do terminala i zmienić tekst w cudzysłowie. Jeśli wolisz zacząć zupełnie bez kodu, przeczytaj najpierw Automatyzacja z AI: od czego zacząć.

Najczęstsze pytania

API co to jest?

API to interfejs programistyczny, czyli umowa między programami: jeden wysyła zapytanie w ustalonym formacie, drugi odsyła odpowiedź. W AI oznacza to dostęp do modeli takich jak GPT czy Claude z poziomu własnego kodu zamiast okienka czatu.

Ile kosztuje API AI?

Płacisz za tokeny: od 0,10 USD za milion tokenów wejścia (GPT-6 Luna) do 50 USD za milion tokenów wyjścia (GPT-6 Astra, Claude Fable 5.1). Typowe zapytanie na tanim modelu kosztuje setne części centa. Koszt swojego scenariusza policzysz w kalkulatorze.

Czy API AI jest darmowe?

Częściowo. Google ma darmowy poziom Gemini API dla modeli Flash, a OpenRouter 17 darmowych modeli z limitem 50 zapytań dziennie. OpenAI nie ma darmowego poziomu, Anthropic daje niewielkie kredyty na start.

Jak uzyskać klucz API?

Załóż konto na platformie dostawcy (platform.openai.com, platform.claude.com, aistudio.google.com albo openrouter.ai) i utwórz klucz w ustawieniach. Klucz pokazuje się w całości tylko raz. Szczegóły i zasady bezpieczeństwa: Klucz API.

Czy abonament ChatGPT Plus daje dostęp do API?

Nie. API OpenAI to osobne konto z osobną przedpłatą, tak samo w przypadku Claude i Gemini.

Co to jest OpenRouter?

Pośrednik, który daje jeden klucz do ponad 460 modeli różnych firm, po cenach dostawców, z prowizją 5,5% od doładowania. Na nim testowałem całą ścieżkę: przewodnik po OpenRouter.

Czy muszę umieć programować, żeby korzystać z API?

Do pierwszych zapytań nie - wystarczy curl albo gotowy skrypt z paczki. Do własnych automatyzacji przyda się podstawowy Python albo narzędzie no-code, które wysyła zapytania za Ciebie.

Który język programowania wybrać do API AI?

Python - ma najwięcej przykładów i oficjalne biblioteki wszystkich dostawców. JavaScript (Node.js) jest drugim wyborem, zwłaszcza gdy budujesz stronę albo bota. Kod w obu wygląda prawie tak samo.

Źródła i data sprawdzenia

Ceny i dokumentację sprawdziłem 4 października 2026. Skrypty uruchomiłem tego samego dnia na Windows 11 przez OpenRouter.

• OpenAI - cennik API
• Anthropic - cennik API
• Google - cennik Gemini API
• DeepSeek - cennik
• xAI - modele i ceny
• OpenRouter - dokumentacja
• OpenRouter - katalog modeli (API)
• openai-python - biblioteka