Новость23.10.2026

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

На странице · 2 разделов

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

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

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

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

В LM Studio откройте Developer → Start server. Ниже используется 127.0.0.1:1234; посмотрите фактический порт в интерфейсе и при необходимости замените его во всех командах. Не включайте доступ для других устройств ради этого опыта. Если вы включили требование токена, применяйте свой токен в каждом запросе согласно отдельному гайду по аутентификации: приведённые команды рассчитаны на сервер без обязательного токена, а не предлагают отключить защиту. s4 s5
В «Терминале» выполните curl -sS 'http://127.0.0.1:1234/api/v1/models'. Найдите свою модель по key, затем в ней массив loaded_instances и скопируйте точный id нужного загруженного экземпляра. Если loaded_instances пуст, выгружать в этой записи нечего. Не подставляйте display_name или размер файла вместо id; если моделей несколько, сверяйте именно свою запись. 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
Ещё раз выполните curl -sS 'http://127.0.0.1:1234/api/v1/models'. Найдите прежнюю запись модели по key. Посмотрите её loaded_instances: там больше не должно быть id, который вы отправили. Другие загруженные экземпляры могут остаться. Сама модель всё ещё может числиться в models, поскольку её файл остаётся скачанным. Точное количество освобождённой памяти без отдельного измерения неизвестно. s2

Маленький учебный пример: допустим, в вашем собственном ответе у модели sample/model есть loaded_instances:[{"id":"sample/model"}]. Тогда в теле POST после подстановки будет {"instance_id":"sample/model"}; в следующем GET именно этот id должен отсутствовать. sample/model — условное значение для объяснения, не предлагаемая для скачивания модель и не реальный ответ редакционного сервера. Если API недоступен, проверьте Developer, порт и токен; если список после POST не изменился, сверьте фактический ответ сервера и идентификатор. Хотите вернуть этот экземпляр позже — загрузите скачанную модель снова. Для выгрузки после периода бездействия вместо ручного запроса есть другая настройка; для удаления файла — отдельная инструкция. s1 s2

Источники

LM Studio — POST /api/v1/models/unload — Поле instance_id и ответ; HTML/SHA-256 в research/raw/2026-10-23/seo/lm-studio-api-vygruzit-model/.. Получено 23.10.2026.
LM Studio — GET /api/v1/models — Различие key и loaded_instances[].id; модель в списке после выгрузки сохраняется.. Получено 23.10.2026.
LM Studio — native REST API v1 — Маршрут /api/v1/* появился в LM Studio 0.4.0; отдельно от совместимого /v1/*.. Получено 23.10.2026.
LM Studio — локальный API-сервер — Developer → Start server, localhost и отдельная настройка доступа из сети.. Получено 23.10.2026.
LM Studio — аутентификация API — Авторизация по умолчанию выключена; если включена, токен обязателен для каждого запроса.. Получено 23.10.2026.
LM Studio — системные требования Mac — Apple Silicon, macOS 14+, 16 ГБ RAM рекомендуется; не превращать это в минимум для любой модели.. Получено 23.10.2026.