Модель пропала из списка моделей — почему так и что делать

Вы настроили агент, выбрали модель, всё работало. Через день она исчезла из списка, который отдаёт /v1/models, и клиент показывает её как недоступную.

Это не сбой. Разберём, что за этим стоит.

Список — это снимок, а не каталог

Многие воспринимают список моделей как прайс: перечень того, что в принципе продаётся. На практике полезнее другое — перечень того, что отвечает прямо сейчас.

Разница проявляется в конкретный неприятный момент. Поставщик модели лёг, а модель в списке осталась. Вы открываете свой агент, выбираете её первой попавшейся, получаете отказ и делаете единственный доступный вывод: сломан весь сервис. Хотя рядом в том же списке пять моделей, которые работают.

Поэтому модели, которые в данный момент не отвечают на проверку, из списка убираются. Проверка — это короткий настоящий запрос к поставщику, а не пинг: ответ с кодом 200 и пустым содержимым успехом не считается.

Будет ли она работать по прямому запросу

Да. Из списка модель убирается, но обслуживаться не перестаёт.

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

Эта строчка нужна ровно для того, чтобы вы не сделали вывод про весь сервис по одной модели.

Другие причины исчезновения

Модель снята с обслуживания. Поставщики регулярно убирают старые версии. В этом случае запрос вернёт ошибку 503 с кодом model_disabled — выберите замену из актуального списка /v1/models и поменяйте имя в настройках.

Поставщик убрал её у себя. Бывает и молча: модель отвечает model not found, хотя вчера работала. Тут ничего не поделать, кроме как перейти на другую.

Она выключена администратором. Например, на время разбирательства с поставщиком. Запрос к ней тоже вернёт 503 model_disabled; такая модель вернётся, когда вопрос решится.

Что делать на своей стороне

Не зашивайте имя модели в код намертво. Самое надёжное — брать список перед началом работы и выбирать из него:

curl https://api.zukko.pro/v1/models -H "Authorization: Bearer fetch_ваш_ключ"

Если вам нужна конкретная модель и ничего другого — предусмотрите запасную. В агентных сценариях это особенно важно: длинная задача, упавшая на середине из-за недоступности модели, стоит дороже, чем пара строк кода с переключением.

for model in ("claude-opus-5-5", "gpt-5.6-sol", "glm-5.3"):
    try:
        return call(model, messages)
    except ProviderUnavailable:
        continue

Как посмотреть состояние

Текущее состояние моделей доступно публично, без ключа:

curl https://api.zukko.pro/api/status

Ответ показывает по каждой модели одно из состояний: работает, подтормаживает, не отвечает или нет данных. Это честнее, чем страница статуса, которую обновляют вручную: данные собираются из реальных запросов и активных проверок, а не из чьего-то мнения о происходящем.