1. Czym jest API i jak łączy programy?
API (Application Programming Interface) to sposób, w jaki jeden program udostępnia funkcje lub dane innemu programowi według ściśle ustalonych zasad.
Dzięki API aplikacja może korzystać z zaawansowanej zewnętrznej usługi (np. modelu językowego LLM, generatora obrazów, serwera bazy danych) bez konieczności poznawania jej wewnętrznej implementacji ani ręcznego instalowania całego silnika na własnej maszynie.
2. Jak działa API? Endpointy i format JSON
Typowy schemat komunikacji przez API HTTP wygląda następująco:
1. Aplikacja wysyła żądanie do wybranej usługi sieciowej (Request).
2. Żądanie zawiera adres URL, wymagane parametry konfiguracyjne i treść pytania (Payload).
3. Usługa przetwarza żądanie na swoich serwerach obliczeniowych.
4. API zwraca ustrukturyzowaną odpowiedź, niemal zawsze w standardowym formacie JSON (Response).
W architekturze REST API adres konkretnej funkcji lub zasobu w sieci nazywamy endpointem (np. https://api.twojadomena.pl/v1/chat/completions).
3. Przykład zastosowania w modelach językowych AI
Aplikacja (np. bot na Discordzie, skrypt n8n lub interfejs webowy) może wysłać do usługi modelu językowego wiadomość z promptem użytkownika, a następnie odebrać wygenerowaną odpowiedź maszynową. Dostawca chmurowy rozlicza takie żądania według liczby przetworzonych tokenów lub stałego abonamentu.
Przykładowa uproszczona odpowiedź w formacie JSON wygląda tak:
{
"status": "ok",
"answer": "API umożliwia bezpieczną komunikację między programami."
}Rzeczywiste pola zależą od standardu danego dostawcy (np. format OpenAI Chat Completions używany przez większość silników AI).
4. Co to jest klucz API i jak dbać o jego bezpieczeństwo?
Klucz API (API Key) to unikalny ciąg znaków używany przez usługę do identyfikacji klienta, rozliczania kosztów i kontroli uprawnień. Należy traktować go z taką samą ostrożnością jak hasło bankowe:
• Nigdy nie umieszczaj klucza w publicznym repozytorium GitHub/GitLab – automatyczne roboty indeksujące kradną klucze w kilka sekund.
• Nie zapisuj kluczy w kodzie frontendowym (JS/HTML), który jest pobierany do przeglądarki użytkownika.
• Przechowuj klucze w zmiennych środowiskowych (pliki .env) lub menedżerze sekretów serwera.
• W razie podejrzenia wycieku natychmiast unieważnij (revoke) stary klucz w panelu dostawcy i wygeneruj nowy.
5. API lokalne a API w chmurze
W nowoczesnych wdrożeniach AI wyróżniamy dwa główne podejścia:
• API lokalne: Silnik (np. Ollama, llama.cpp, vLLM) działa w Twojej sieci lokalnej lub na własnym serwerze VPS. Wszystkie dane pozostają w 100% prywatne, nie ponosisz opłat za tokeny, a zapytania nie opuszczają Twojej infrastruktury.
• API w chmurze: Usługa udostępniana przez komercyjnego dostawcę (np. OpenAI, Anthropic, Groq, OpenRouter). Wymaga stabilnego łącza internetowego, oferuje natychmiastowy dostęp do najpotężniejszych modeli bez inwestycji w karty GPU, ale wiąże się z opłatami za każde wywołanie.