Modele własnego endpointu nie pojawiają się na liście w kliencie

Klient albo nie pobrał listy, albo pobrał ją ze złej ścieżki, albo całkowicie ją ignoruje na rzecz zakodowanego na sztywno zestawu. Najpierw sprawdź, co zwraca endpoint, a potem ustal, z którym z tych trzech przypadków masz do czynienia.

Co widzisz

The model dropdown is empty after switching to a custom endpoint
Only the provider's built-in model names are offered
A model you know exists is not selectable
Typing the model name manually works, picking it from the list does not

Dlaczego tak się dzieje

Klienty z zakodowanymi na sztywno nazwami modeli były budowane pod jednego dostawcę. Skierowanie ich gdzie indziej daje właściwy endpoint ze złym menu, a nazwy, które wysyłają, mogą w ogóle nie istnieć po stronie upstream.

Klienty, które pobierają listę, zwykle wywołują GET /v1/models. Jeśli w twoim base URL brakuje prefiksu wersji, to wywołanie po cichu dostaje 404, a lista rozwijana pozostaje pusta bez żadnego komunikatu.

Niektóre klienty agresywnie zapisują listę w cache. Model dodany po stronie upstream po skonfigurowaniu klienta nie pojawi się, dopóki cache nie zostanie wyczyszczony albo aplikacja nie zostanie zrestartowana.

Sprawdź, czy to ta przyczyna

Zapytaj endpoint bezpośrednio – to właśnie widzi poprawnie działający klient:

curl -s 'YOUR_BASE_URL/models' -H 'Authorization: Bearer YOUR_KEY' \
  | head -c 400

Lista w JSON oznacza, że endpoint jest w porządku, a problemem jest klient. 404 oznacza zły base URL; HTML oznacza, że wskazuje na stronę WWW.

Jak to naprawić

Wpisz nazwę modelu ręcznie, jeśli klient na to pozwalaWiększość klientów gdzieś przyjmuje dowolny tekst w polu modelu, nawet gdy lista rozwijana jest stała. To całkowicie omija listę.
Użyj mapowania modeli, gdy nazw nie da się zmienićJeśli klient upiera się przy własnych identyfikatorach, zmapuj je na nazwy obsługiwane przez endpoint. Niektóre narzędzia po stronie klienta udostępniają to bezpośrednio.
Zrestartuj po zmianie endpointuKonfiguracja i listy modeli są zwykle odczytywane przy uruchomieniu. Zamknięcie okna nie zawsze wystarcza – całkowicie zakończ aplikację.

GET /v1/models w APICLAN zwraca dokładnie to, do czego ma dostęp twój klucz, bo lista jest budowana na podstawie grupy klucza. To wiążąca odpowiedź dla twojego konta, a nie ogólny katalog.

Powiązane

Unexpected token '<' przy wywołaniu API zgodnego z OpenAI 401 invalid API key – gdy klucz wygląda dobrze, a i tak nie działa

Ostatnio sprawdzono 2026-10-01. Napisane na podstawie problemów zdiagnozowanych na działającej bramce zgodnej z OpenAI, a nie zebrane z innych stron.