Ollama API: 404 page not found — проверить путь запроса
На странице · 3 разделов
При ответе 404 page not found сначала сравните путь запроса с адресами API той версии Ollama, которая запущена у вас. На локальном сервере проверьте /api/version: он позволяет проверить адрес без загрузки модели. Не всякий HTTP 404 означает опечатку в пути: отсутствующая модель тоже может вернуть 404, но с сообщением о модели; ответ прокси требует отдельной диагностики.
Программа обращается к Ollama и получает 404 page not found? Для начала проверьте точный адрес запроса, а не скачивайте модель повторно. В версии v0.40.13 Ollama отвечает на GET /api/version, но адрес с лишней буквой — уже другой путь. Если 404 содержит текст model not found, проблема может быть не в пути, а в имени модели. s1 s2 s3
Статус проверки: инструкция основана на документации и коде Ollama v0.40.13; редакция не запускала Ollama или модель. Ниже — инженерная проверка на Linux с curl в терминале; Ollama должна быть установлена и запущена на том же компьютере. Локальный запрос не требует интернета или скачивания весов. Нужен другой компьютер, контейнер или прокси? Не подставляйте его адрес вместо 127.0.0.1 вслепую: сперва проверьте, к какому серверу идёт запрос. s1 s2
Как проверить адрес сервера без модели?
На компьютере с работающей Ollama откройте терминал и выполните curl -i --max-time 10 'http://127.0.0.1:11434/api/version'. Ожидаемый результат — HTTP 200 и JSON с полем version. Это проверка маршрута и адреса, не работы модели. Если вместо HTTP-ответа возникает отказ в соединении, проверьте запуск программы и порт по гайду проверки Ollama. s1 s2
Как найти опечатку в пути?
Сравните свой исходный URL посимвольно с маршрутом в документации. Например, в закреплённом коде есть /api/version, но нет /api/versions с буквой s на конце. Для учебной отрицательной проверки выполните curl -i --max-time 10 'http://127.0.0.1:11434/api/versions': на рассмотренном локальном сервере ожидается HTTP 404 с текстом 404 page not found. Это поведение маршрутизатора Gin, от версии которого зависит Ollama v0.40.13. Не меняйте рабочий адрес в программе на заведомо ошибочный — это только пример для сравнения ответов. Если в обоих случаях одинаковая страница ошибки, возможно, запрос попадает не к той Ollama; выясните адрес и настройки промежуточного сервера. s1 s2 s3
Адрес /api сам по себе — начало пути, а не проверка версии; нативные пути /api/... и совместимые с OpenAI пути /v1/... не взаимозаменяемы. У /api/show и /api/chat в этой версии нужен POST, а не GET: неверный метод для существующего пути — отдельный случай HTTP 405. s1 s2
Что делать, если путь верный, а HTTP 404 остался?
Прочитайте тело ответа: в коде Ollama генерация с отсутствующей моделью тоже может отвечать 404, но с сообщением вида model '…' not found. Тогда проверьте точное имя и тег на том же сервере через GET /api/tags и инструкцию по ошибке модели. Не считайте любой 404 доказательством опечатки и не удаляйте файлы вслепую. s1 s2
Если GET /api/version на самом компьютере возвращает версию, а прежний адрес через прокси — HTML-страницу 404, это различие ещё не устанавливает точную конфигурационную ошибку: сверяйте хост, порт и переписывание пути на промежуточном узле. Сообщение 404 без проверки конечного сервера не позволяет сделать вывод о его причине. s2
Следующий шаг: проверьте доступность сервера, список локальных моделей и пробный ответ отдельно. Не принимайте успешный ответ /api/version за подтверждение, что выбранная модель умеет отвечать. s1 s2
Источники
- Ollama v0.40.13: документация API — revision 04088e7c9d41cba5d33bafbf788d87a465c79d5b; Сохранённый raw с SHA в research/raw/2026-11-01/seo/ollama-api-404-page-not-found/. Получено 01.11.2026.
- Ollama v0.40.13: маршруты и ошибки в server/routes.go — revision 04088e7c9d41cba5d33bafbf788d87a465c79d5b; Маршруты строки 2383–2440, отсутствие модели строка 362; сохранённый raw и SHA в каталоге исследования.. Получено 01.11.2026.
- Gin v1.12.0: default404Body и ServeHTTP в gin.go — revision v1.12.0 (версия зависимости из go.mod Ollama v0.40.13); Строки 33 и 738–759; сохранённый исходник и go.mod с SHA в каталоге исследования.. Получено 01.11.2026.