Strona główna → Pomoc

Model not found – gdy nazwa modelu jest prawie dobra

Wylistuj modele, do których twój klucz ma dostęp, i porównaj nazwę znak po znaku. Identyfikatory modeli muszą pasować dokładnie, a rodziny modeli rzadko są konsekwentne w separatorach.

Co widzisz

Dlaczego tak się dzieje

Zwykle winne jest nazewnictwo, a to naprawdę trudno zgadnąć. W jednej rodzinie znajdziesz wersje zapisane z kropką w jednym wydaniu i z myślnikiem w kolejnym – nazwa, która dla człowieka brzmi identycznie, dla API jest innym ciągiem znaków.

Druga przyczyna to dostęp, a nie nazwa. W bramkach, gdzie klucze należą do planu lub grupy, model może istnieć na platformie, a mimo to leżeć poza tym, co wolno wywołać twojemu kluczowi. Komunikat często nie rozróżnia tych dwóch przypadków, więc ludzie szukają literówki, której nie ma.

W bramce komunikat może też wskazywać grupę zamiast modelu: Model "gpt-4o" is not supported by any configured account in this group. Warto przeczytać to uważnie — nie mówi, że model jest niedostępny wszędzie, tylko że konta stojące za grupą twojego klucza go nie obsługują. Ten sam tekst pojawia się, gdy pomylisz nazwę i gdy wybierzesz model spoza planu, więc sprawdź listę, zanim założysz którąkolwiek wersję.

Sprawdź, czy to ta przyczyna

Zapytaj API, co widzi twój klucz, zamiast ufać stronie dokumentacji:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | grep -o '"id":"[^"]*"'

Jeśli modelu nie ma na tej liście, żadne poprawianie pisowni nie pomoże – klucz nie ma do niego dostępu.

Jak to naprawić

  1. Kopiuj identyfikator, nigdy go nie przepisujBierz ciąg znaków prosto z listy modeli. Kropka kontra myślnik oraz sufiksy wersji z datą to dwie rzeczy, w których ludzie najczęściej się mylą.
  2. Sprawdź zakres kluczaJeśli model jest w publicznej dokumentacji, ale nie na twojej liście, problemem jest to, do czego klucz ma dostęp. Klucz jednego planu zwykle nie może wywołać modeli innego planu.
  3. Uważaj na aliasy, które znikająWygodne aliasy wskazujące na aktualną wersję mogą zostać wycofane bez ostrzeżenia. Przypięcie pełnego identyfikatora jest bardziej rozwlekłe i znacznie stabilniejsze.
W APICLAN każdy klucz należy do jednej grupy, a GET /v1/models zwraca dokładnie to, co ten klucz może wywołać. Aktualne identyfikatory modeli i ceny są na stronie głównej.

Powiązane

Unexpected token '<' przy wywołaniu API zgodnego z OpenAI401 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.