# LM Studio API: выгрузить модель из памяти и проверить результат

Источник: https://modelium.tech/zhurnal/lm-studio-api-vygruzit-model/

Если модель уже загружена, найдите её instance_id в GET /api/v1/models и передайте этот идентификатор в POST /api/v1/models/unload. Затем снова проверьте loaded_instances: выбранного экземпляра там быть не должно. Выгрузка из памяти не удаляет скачанную модель с диска. Это инструкция по документации, а не результат запуска LM Studio редакцией.

Нужно **остановить загруженную модель LM Studio, не удаляя её файл**? На собственном компьютере узнайте идентификатор работающего экземпляра, выгрузите именно его через API и убедитесь, что он исчез из списка загруженных. API — интерфейс, через который одна программа отдаёт другой команду. Это действие не предназначено для удаления скачанных весов. [s1](#src-s1) [s2](#src-s2)

**Инженерный уровень; инструкция по документации на 23 октября 2026 года.** Нужны Mac с Apple Silicon и macOS 14+, LM Studio 0.4.0 или новее, уже скачанная и загруженная модель и «Терминал». Разработчик рекомендует 16 ГБ оперативной памяти для приложения; это не минимальный объём памяти для вашей конкретной модели. Адрес `127.0.0.1` обращается к серверу на вашем компьютере. Интернет требуется заранее для установки и получения модели; весь сетевой трафик LM Studio и офлайн-режим редакция не проверяла. Сами LM Studio и модель редакция не запускала: ниже сверенная инструкция и учебная проверка команд на фикстуре. [s3](#src-s3) [s4](#src-s4) [s6](#src-s6)

## Как выбрать нужный загруженный экземпляр?

- В LM Studio откройте **Developer → Start server**. Ниже используется `127.0.0.1:1234`; посмотрите фактический порт в интерфейсе и при необходимости замените его во всех командах. Не включайте доступ для других устройств ради этого опыта. Если вы включили требование токена, применяйте свой токен в **каждом** запросе согласно отдельному [гайду по аутентификации](/zhurnal/lm-studio-api-autentifikaciya/): приведённые команды рассчитаны на сервер без обязательного токена, а не предлагают отключить защиту. [s4](#src-s4) [s5](#src-s5)

- В «Терминале» выполните `curl -sS 'http://127.0.0.1:1234/api/v1/models'`. Найдите свою модель по `key`, затем в ней массив `loaded_instances` и скопируйте точный `id` нужного загруженного экземпляра. Если `loaded_instances` пуст, выгружать в этой записи нечего. Не подставляйте `display_name` или размер файла вместо `id`; если моделей несколько, сверяйте именно свою запись. [s2](#src-s2)

## Как выгрузить и проверить, что она остановилась?

- В команде **вручную замените** `INSTANCE_ID_FROM_LIST` точным `id` из предыдущего шага, оставив кавычки: `curl -sS -X POST 'http://127.0.0.1:1234/api/v1/models/unload' -H 'Content-Type: application/json' -d '{"instance_id":"INSTANCE_ID_FROM_LIST"}'`. API должен вернуть поле `instance_id` выгруженного экземпляра. Сравните его с тем, что отправляли; не принимайте сообщение об ошибке за успех. [s1](#src-s1)

- Ещё раз выполните `curl -sS 'http://127.0.0.1:1234/api/v1/models'`. Найдите прежнюю запись модели по `key`. Посмотрите её `loaded_instances`: там больше не должно быть `id`, который вы отправили. Другие загруженные экземпляры могут остаться. Сама модель всё ещё может числиться в `models`, поскольку её файл остаётся скачанным. Точное количество освобождённой памяти без отдельного измерения неизвестно. [s2](#src-s2)

**Маленький учебный пример:** допустим, в *вашем собственном ответе* у модели `sample/model` есть `loaded_instances:[{"id":"sample/model"}]`. Тогда в теле POST после подстановки будет `{"instance_id":"sample/model"}`; в следующем GET именно этот `id` должен отсутствовать. `sample/model` — условное значение для объяснения, не предлагаемая для скачивания модель и не реальный ответ редакционного сервера. Если API недоступен, проверьте Developer, порт и токен; если список после POST не изменился, сверьте фактический ответ сервера и идентификатор. Хотите вернуть этот экземпляр позже — [загрузите скачанную модель снова](/zhurnal/lm-studio-api-zagruzit-model/). Для выгрузки **после периода бездействия** вместо ручного запроса есть [другая настройка](/zhurnal/lm-studio-vygruzka-modeli-po-prostoyu/); для удаления файла — [отдельная инструкция](/zhurnal/lm-studio-udalit-skachannuyu-model/). [s1](#src-s1) [s2](#src-s2)

## Источники

1. [LM Studio — POST /api/v1/models/unload](https://lmstudio.ai/docs/developer/rest/unload) — получено 2026-10-23
2. [LM Studio — GET /api/v1/models](https://lmstudio.ai/docs/developer/rest/list) — получено 2026-10-23
3. [LM Studio — native REST API v1](https://lmstudio.ai/docs/developer/rest) — получено 2026-10-23
4. [LM Studio — локальный API-сервер](https://lmstudio.ai/docs/developer/core/server) — получено 2026-10-23
5. [LM Studio — аутентификация API](https://lmstudio.ai/docs/developer/core/authentication) — получено 2026-10-23
6. [LM Studio — системные требования Mac](https://lmstudio.ai/docs/app/system-requirements) — получено 2026-10-23