Rozwiązywanie problemów z adresami URL OpenAI Base
Zmiana modeli powinna być prosta. Zmieniasz endpoint i zachowujesz to samo SDK.
W rzeczywistych projektach pierwsze uruchomienie często kończy się niepowodzeniem. Pojawiają się błędy takie jak 401, 404 lub 429.
Skorzystaj z tej listy kontrolnej, zanim zaczniesz obwiniać SDK.
Sprawdź prefiks /v1 Większość bramek (gateways) wymaga przyrostka /v1 w adresie URL. Jeśli użyjesz tylko domeny, SDK może wywołać błędną ścieżkę. Skopiuj dokładny format z dokumentacji dostawcy.
Zweryfikuj swoje klucze API Mieszanie kluczy powoduje błędy. Sprawdź te częste pomyłki: • Używanie klucza OpenAI z adresem URL typu relay. • Używanie klucza relay z adresem URL OpenAI. • Używanie klucza z wyłączonego projektu. • Dodanie spacji na początku lub na końcu klucza. Jeśli zobaczysz błąd 401, wypisz pierwszy i ostatni znak swojego klucza, aby porównać go z tym w panelu sterowania (dashboard). Nie loguj pełnego klucza.
Dopasuj nazwy modeli dokładnie Nie zgaduj nazw modeli. Nazwy bramek ulegają zmianom. Błędna nazwa prowadzi do błędów 404 lub model_not_found. Skopiuj ID modelu bezpośrednio z aktualnej listy modeli.
Najpierw wykonaj małe zapytanie Zanim zaczniesz debugować całą aplikację, wykonaj mały test. Użyj prostej wiadomości „ping” i niskiej wartości max_tokens. Jeśli to działa, Twój adres URL, klucz i model są poprawne. Błąd znajduje się w logice Twojej aplikacji, np. w strumieniowaniu (streaming) lub wywoływaniu narzędzi (tool calling).
Zrozum kody błędów • 401 oznacza problem z kluczem lub kontem. • 429 oznacza limit zapytań (rate limit) lub problem ze stanem konta. Jeśli zobaczysz 429, sprawdź stronę płatności (billing). Unikaj zbyt gęstych pętli ponawiania prób (retry loops). Powodują one pogorszenie problemu.
Sprawdź stronę ze statusem Jeśli Twój kod działał wczoraj, a dziś zawodzi, nie przepisuj swojej integracji. Najpierw sprawdź stronę statusu dostawcy. Często przyczyną jest incydent po stronie dostawcy (upstream incident).
Użyj polecenia curl Trzymaj proste polecenie curl w dokumentacji swojego projektu.
Gdy Twoja aplikacja przestanie działać, najpierw uruchom polecenie curl. Jeśli curl zawiedzie, problem leży w koncie, bramce lub sieci. Jeśli curl działa, problemem jest kod Twojej aplikacji.