Jak zintegrować OpenAI API z aplikacją

Aby zintegrować OpenAI API, utwórz klucz API w projekcie OpenAI, przechowuj go jako sekret po stronie serwera o nazwie OPENAI_API_KEY i wywołuj API z trasy na własnym serwerze, używając oficjalnego SDK OpenAI — nigdy z kodu przeglądarki. Według stanu na wrzesień 2026 r. szybki start OpenAI przedstawia Responses API jako punkt wyjścia dla nowych projektów. Przed startem ustaw limit wydatków, ogranicz długość odpowiedzi, ustaw, jak często każdy użytkownik może wywoływać funkcję, i obsłuż błędy limitu zapytań ponowieniami.

Ten przewodnik obejmuje konfigurację, przebieg żądania, prompty dla narzędzia do budowy aplikacji AI oraz błędy, które wyciekają klucze lub przepalają pieniądze. Szczegóły OpenAI pochodzą z ich oficjalnej dokumentacji według stanu na wrzesień 2026 r. Najpierw przeczytaj ogólne pojęcia (tokeny, okna kontekstu, ceny) w jak korzystać z API LLM.

Co możesz dzięki temu zbudować

• Asystenta czatu w swojej aplikacji (jak zbudować aplikację chatbota AI)
• Przyciski „Podsumuj to", „Przepisz to" lub „Zaproponuj odpowiedź"
• Wyciąganie danych strukturalnych z tekstu: zamiana e-maila na zamówienie, oznaczanie zgłoszeń do wsparcia
• Wyszukiwanie i odpowiadanie na pytania na podstawie Twoich własnych treści
• Generowanie obrazów, mowę i inne funkcje multimedialne, zależnie od dostępnych modeli

Więcej pomysłów znajdziesz w jak dodać funkcje AI do aplikacji.

Konfiguracja konta OpenAI

1. Utwórz konto i projekt na platformie OpenAI. Najlepsze praktyki produkcyjne OpenAI zalecają osobne projekty dla środowiska testowego i produkcyjnego, tak by każdy miał własne klucze i limity.
2. Utwórz klucz API projektu. OpenAI zaleca ustawienie daty wygaśnięcia i regularną rotację kluczy.
3. Ustaw alerty wydatków i twardy limit wydatków na stronie limitów. Przewodnik OpenAI wyjaśnia, że alerty informują, gdy zużycie przekroczy kwotę, a twardy limit egzekwuje miesięczny pułap.
4. Dodaj płatności. Dokumentacja limitów OpenAI opisuje poziomy użycia: Twoje limity rosną automatycznie, gdy z czasem wydajesz więcej.

Przebieg żądania

Przeglądarka  ->  trasa na Twoim serwerze  ->  OpenAI API
              <-  (strumieniowana) odpowiedź <-

1. Użytkownik klika przycisk lub wysyła wiadomość.
2. Przeglądarka wywołuje Twoją trasę, na przykład POST /api/summarise.
3. Twój serwer sprawdza, czy użytkownik jest zalogowany i może korzystać z funkcji.
4. Serwer buduje żądanie: instrukcje, dane wejściowe użytkownika i dane z bazy, których potrzebuje zadanie.
5. Wywołuje OpenAI z kluczem z konfiguracji środowiska. SDK OpenAI automatycznie odczytuje OPENAI_API_KEY.
6. Strumieniuje lub zwraca odpowiedź i zapisuje zużycie tokenów.

Oficjalne pakiety SDK OpenAI nazywają się openai zarówno dla JavaScript/TypeScript (npm), jak i Pythona (pip).

Wybór modelu

OpenAI oferuje kilka modeli o różnych cenach i szybkościach, a ich oferta często się zmienia. Zacznij od mniejszego, tańszego modelu, zmierz jakość na prawdziwych przykładach i przechodź na droższy tylko wtedy, gdy jest to konieczne. Trzymaj nazwę modelu w wartości konfiguracyjnej lub sekrecie, aby móc ją zmienić bez przepisywania kodu. Aktualne stawki znajdziesz na stronie cennika OpenAI.

Opcje i kompromisy

Prompty dla Twojego narzędzia do budowy aplikacji

Pierwsza funkcja:

Dodaj przycisk „Podsumuj" na stronie zgłoszenia. Wywołuje trasę serwera POST /api/summarise, która sprawdza, czy użytkownik jest zalogowany, ładuje zgłoszenie i wywołuje OpenAI Responses API, używając oficjalnego SDK openai i sekretu OPENAI_API_KEY. Odczytaj nazwę modelu z sekretu OPENAI_MODEL. Instrukcje: „Podsumuj w 3 punktach, a potem zaproponuj krótką odpowiedź. Nie wymyślaj numerów zamówień." Ogranicz długość wyjścia, strumieniuj odpowiedź na stronę i nigdy nie wysyłaj klucza do przeglądarki.

Zabezpieczenia:

Ogranicz każdego użytkownika do 30 żądań AI na godzinę, zapisywanych w bazie danych. Zapisuj liczbę tokenów wejściowych i wyjściowych każdego żądania wraz z ID użytkownika i nazwą funkcji. Jeśli OpenAI zwróci 429, respektuj nagłówek Retry-After, ponawiaj z wykładniczym opóźnieniem i losowym rozrzutem do 3 razy; potem pokaż „AI jest zajęte, spróbuj ponownie za minutę." Przy każdym innym błędzie pokaż przyjazny komunikat i pozwól reszcie strony działać.

Obsługa błędów i limitów

OpenAI mierzy limity zapytań na kilka sposobów, m.in. liczbę żądań na minutę i tokenów na minutę, i trafiasz na ten, który wyczerpie się pierwszy. Gdy go przekroczysz, API zwraca 429 z nagłówkiem Retry-After. Dokumentacja OpenAI zaleca traktować tę wartość jako minimum i dodać krótkie losowe opóźnienie, aby klienci nie ponawiali wszyscy naraz.

Zaplanuj też:

• Limity czasu przy długich generacjach. Streaming pomaga, podobnie jak rozsądny limit długości wyjścia.
• Awarie dostawcy. Funkcja AI powinna zawieść łagodnie, nie psując strony.
• Złe wyniki. Waliduj strukturalne wyjście przed zapisaniem i nie pozwalaj, by wynik modelu uruchamiał wrażliwe działania bez sprawdzenia w Twoim kodzie.

Częste błędy

• Klucz we frontendzie lub w repozytorium. Kod przeglądarki jest publiczny, a wyciekły klucz może być nadużyty w ciągu minut. Zobacz jak chronić klucze API.
• Brak limitu wydatków. Pętla lub nadużywający użytkownik mogą szybko wygenerować duży rachunek.
• Brak limitów na użytkownika. Limit dostawcy chroni Twój portfel, nie Twoich innych użytkowników.
• Ufanie promptowi w kwestii bezpieczeństwa. Użytkownicy mogą wpisać „zignoruj poprzednie instrukcje". Uprawnienia powinny być w kodzie serwera.
• Wysyłanie więcej, niż trzeba. Całe dokumenty i długie historie mnożą koszt. Wysyłaj to, czego potrzebuje zadanie.
• Wpisywanie nazwy modelu na sztywno. Modele są aktualizowane i wycofywane; zrób z tego ustawienie.
• Wysyłanie danych osobowych bez zastanowienia. Przeczytaj warunki wykorzystania danych OpenAI i wysyłaj tylko to, czego potrzebuje funkcja.

Lista kontrolna

• Osobne projekty (lub klucze) OpenAI do testów i do produkcji
• Klucz przechowywany jako sekret po stronie serwera, nigdy w kodzie przeglądarki ani w repozytorium
• Ustawione alerty wydatków i twardy limit wydatków
• Wszystkie wywołania przechodzą przez Twój serwer i sprawdzają uprawnienia użytkownika
• Długość wyjścia ograniczona; nazwa modelu konfigurowalna
• Limit zapytań na użytkownika w Twojej aplikacji
• Obsługa 429 z Retry-After, opóźnieniem wykładniczym i losowym rozrzutem
• Przyjazny stan błędu; strona działa bez AI
• Zużycie tokenów zapisywane dla każdej funkcji
• Przetestowane z długimi, pustymi i wrogimi danymi wejściowymi

Używanie OpenAI API w Mythex

Funkcje AI w aplikacjach budowanych w Mythex używają Twojego własnego klucza OpenAI i są rozliczane na Twoim koncie OpenAI, a nie w kredytach budowania Mythex. Dodaj OPENAI_API_KEY jako sekret projektu przez /secrets, ustawienia projektu lub kartę sekretów, którą agent pokazuje, gdy potrzebuje klucza, a następnie opisz funkcję promptem podobnym do powyższych. Po zmianie sekretów w opublikowanej aplikacji opublikuj ją ponownie, aby je odebrała. Gotowy prompt startowy znajdziesz w przepisie w dokumentacji Dodawanie funkcji AI za pomocą własnych kluczy API, a Sekrety w czacie wyjaśnia kartę sekretów. Porównujesz dostawców? Zobacz jak zintegrować Claude API.

Pytania