Ошибка model not found или 404 в API: модель, адрес или права доступа

При ошибке 404 или model not found сначала сохраните полный текст ответа и итоговый URL запроса. Причиной может быть путь API, идентификатор модели или права текущего ключа. Сам по себе код 404 не указывает, что нужно менять ключ или пополнять баланс.

Сервисы по-разному упаковывают ошибки. Следующие признаки помогают направить диагностику, но не являются универсальными правилами.

Определите, на каком уровне ошибка

Ответ	Что проверить первым
HTML-страница или 404 шлюза	Домен, итоговый путь и HTTP-метод
JSON с model_not_found	ID модели, права ключа и группу доступа
Unsupported endpoint	Протокол клиента и поддерживаемые конечные точки

Некоторые системы скрывают недоступные пользователю модели за сообщением «не найдена». Поэтому такое сообщение не доказывает отсутствие модели у провайдера.

Проверьте итоговый URL

Base URL в настройках и фактический URL запроса — разные вещи. Клиент может автоматически добавлять версию или путь. Сверьтесь с инструкциями именно вашего клиента и сервиса.

Условный пример: база https://api.example.com/v1, клиент добавляет /chat/completions. Итог — https://api.example.com/v1/chat/completions. Ошибочная двойная вставка версии даст /v1/v1/chat/completions.

Открытие базы в браузере и ответ 404 не доказывают неверную настройку. Браузер обычно делает GET; генерация может требовать POST на отдельный путь, а главной страницы у API может не быть.

Скопируйте точный ID модели

Используйте идентификатор из документации или списка, доступного вашему аккаунту. Не заменяйте его маркетинговым названием. Сохраните регистр, дефисы и суффикс версии.

Обновите список в клиенте. Если модель снята с поддержки, выбирайте замену по объявлению провайдера и повторно проверяйте цену и возможности. Не меняйте рабочую модель незаметно только ради успешного ответа.

Проверьте ключ, проект и группу

Общий каталог моделей может показывать больше, чем разрешено вашему ключу. Уточните проект, тариф, группу, список разрешённых моделей и срок действия ключа.

Если сервис поддерживает получение списка моделей через API, используйте тот же ключ. У некоторых посредников этот метод отсутствует; тогда нужен другой предусмотренный ими способ проверки. Успешное получение списка всё равно не заменяет запрос на генерацию.

Убедитесь в совместимости протокола

Chat Completions, Responses и протоколы других производителей могут иметь разные пути, поля и форматы ответов. Поддержка одной схемы не означает поддержку всех.

Нельзя просто переименовать путь и оставить несовместимое тело запроса. Сначала выполните минимальный пример сервиса для требуемого протокола. После короткого текстового ответа поочерёдно включайте инструменты, изображения и другие возможности.

Меняйте по одному параметру

Если при том же ключе и адресе другая подтверждённо доступная модель работает, проверяйте права и канал исходной. Если пример провайдера работает, а клиент — нет, исследуйте построение пути и тела запроса клиентом.

Сохраните результат каждого изменения. Реальная генерация может стоить денег, поэтому ограничьте тестовый бюджет и не запускайте бесконечные повторения.

Поддержке нужны версия клиента, очищенный URL, метод, модель, группа, текст ошибки и ID запроса. Уберите заголовок Authorization, полный ключ и личное содержимое.

Новый ключ поможет? Только если причина в его статусе или правах; ошибочный путь он не исправит.

Нужно пополнить баланс? Сначала получите подтверждение ограничения тарифа или квоты, а не ориентируйтесь только на 404.

Далее: Base URL и ID модели, общая диагностика подключения, каталог провайдеров.