Что на самом деле говорит ошибка
Сервер принял запрос, понял ключ, но не нашёл вызываемую модель с таким именем. В OpenAI-совместимом API это HTTP 404 с кодом model_not_found. В Model.sale сообщение выглядит так: The model '<id>' does not exist or is not available. GET /v1/models lists callable models.
Отличайте её от соседних. 401 invalid_api_key — проблема с ключом. 403 model_not_allowed — ключ есть, но он ограничен другими моделями. 404 на пути вроде /v1/response (опечатка в endpoint) — проблема URL, а не модели. Сначала прочитайте статус и код: это сэкономит большую часть отладки.
1. Берите ID из списка, а не из памяти
ID модели — точная строка: нижний регистр, дефисы, без пробелов. gpt-6-sol работает, а «GPT-6 Sol», gpt6-sol и gpt_6_sol — нет. Названия в интерфейсе и статьях — это отображаемые имена. Спросите у сервера, что он может вызвать: curl https://api.model.sale/v1/models -H "Authorization: Bearer $MODEL_SALE_KEY" вернёт актуальные ID, те же строки есть на страницах моделей.
Агрегаторы часто добавляют префикс вендора, например openai/gpt-6-sol. В Model.sale ID без префикса, поэтому имя из примера OpenRouter нужно очистить от префикса. Верно и обратное: ID без префикса, отправленный в сервис с префиксами, не найден.
2. Модель может быть временно недоступна
Модели маршрутизируются на внешние мощности, которые могут отказывать. Model.sale постоянно проверяет каждую модель и убирает её из GET /v1/models, пока проверки не проходят; запрос к ней возвращает тот же 404 до восстановления. Если вчерашней модели нет в списке, это обычно оно, а не опечатка. Переключитесь на соседнюю модель (например, gpt-6-sol вместо gpt-6.1-sol) и повторите позже.
Второй источник — старые сниппеты. Туториал или конфиг агента с жёстко заданным ID полугодовой давности продолжает падать после переименования или снятия модели. Считайте список источником правды и храните ID в одном значении конфига, а не по всему коду.
3. Проверьте, что разрешено ключу
У ограниченного ключа может быть список разрешённых моделей. Запрос к любой другой модели падает с 403 model_not_allowed, а некоторые клиенты показывают это как «model not found». Откройте Dashboard, API keys и сравните разрешённые модели ключа с отправляемым ID. Это типичная причина, когда один проект работает, а другой с другим ключом — нет.
Проверьте и то, что ключ принадлежит аккаунту, который вы пополнили. Ключ от старого тестового аккаунта может проходить аутентификацию и при этом не иметь ничего, что можно вызвать.
4. Убедитесь, что запрос идёт на нужный base URL
Классическая ошибка — клиент игнорирует ваш base URL и обращается на endpoint по умолчанию. Тот ищет gpt-6-sol, не знает такой модели и отвечает model not found. Убедитесь, что base URL — https://api.model.sale/v1 и инструмент действительно им пользуется: выведите URL в debug-логах SDK или сначала вызовите endpoint через curl.
По клиентам: официальные SDK читают OPENAI_BASE_URL, старые обёртки — OPENAI_API_BASE, в Cursor нужно включить Override OpenAI Base URL, Codex CLI требует custom provider с base_url и wire_api = "responses". Cursor и похожие редакторы хранят свой список моделей, поэтому имя своей модели нужно добавить и там. В блоге есть руководство по base URL для каждого клиента.
5. Совместите endpoint и модель
Модели перечисляют поддерживаемые endpoint, обычно /v1/responses и /v1/chat/completions. Клиент, который настаивает на одном endpoint (например, старый плагин, говорящий только на Chat Completions), может падать на модели, у которой есть только другой. На странице модели указаны проверенные endpoint: выберите модель, поддерживающую тот, что использует ваш инструмент.
Чек-лист на 30 секунд
Первое: прочитайте статус и код. Второе: вызовите GET /v1/models с тем же ключом и проверьте, что ID есть в списке, символ в символ. Третье: проверьте разрешённые модели ключа в дашборде. Четвёртое: убедитесь, что запрос доходит до api.model.sale. Пятое: повторите с крошечным промптом вроде «Say hello», прежде чем винить модель.
Если ID есть в списке, ключ его разрешает, URL верный, а 404 остаётся, сохраните ID запроса из заголовка x-model-sale-request-id и напишите в поддержку. Не вставляйте в сообщение ключ и промпты.