# LM Studio API: скачать модель и проверить окончание загрузки

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

В LM Studio 0.4.0+ отправьте POST /api/v1/models/download с идентификатором модели. Если ответ содержит job_id, проверяйте его через GET /api/v1/models/download/status/:job_id до completed, затем откройте GET /api/v1/models. already_downloaded означает, что файл уже есть; скачивание само по себе не запускает модель. Это инструкция по документации, а не результат запуска редакцией.

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

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

## Как начать скачивание?

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

- В «Терминале» выполните `curl -sS -X POST 'http://127.0.0.1:1234/api/v1/models/download' -H 'Content-Type: application/json' -d '{"model":"ibm/granite-4-micro"}'`. `ibm/granite-4-micro` — пример каталожного идентификатора **из документации LM Studio**, не обещание совместимости или достаточности памяти вашего Mac. Если нужен другой вариант, укажите его точный каталожный ID. Тот же адрес API принимает точную ссылку Hugging Face; выбрать `quantization` (вариант сжатия весов) здесь можно только при использовании такой ссылки. У нового задания скопируйте `job_id` из ответа. Если ответ сразу показывает `already_downloaded`, файл уже скачан и `job_id` может отсутствовать: переходите к проверке списка. Ошибку API или отказ в доступе нельзя принимать за начало загрузки. [s1](#src-s1)

## Как проверить файл и перейти к запуску?

- Если получили `job_id`, **вручную замените** `JOB_ID_FROM_RESPONSE` на точное значение из ответа и выполните `curl -sS 'http://127.0.0.1:1234/api/v1/models/download/status/JOB_ID_FROM_RESPONSE'`. Повторяйте запрос через некоторое время, пока `status` не станет `completed`. `downloading` ещё не окончание, `paused` — пауза, `failed` — ошибка; в последних двух случаях посмотрите ответ, сеть и доступное место, не переходите к запуску модели как будто файл готов. [s2](#src-s2) [s8](#src-s8)

- После `completed` или `already_downloaded` выполните `curl -sS 'http://127.0.0.1:1234/api/v1/models'`. Найдите выбранную модель в массиве `models` и сверьте её `key`; `loaded_instances` может быть пустым — это не ошибка скачивания, а отсутствие загруженного в память экземпляра. Если нужной записи нет или API вернул ошибку, не считайте задачу подтверждённой и проверьте имя модели, номер задания и ответ сервера. Следующий шаг — [отдельно загрузить скачанную модель в память](/zhurnal/lm-studio-api-zagruzit-model/) и получить тестовый ответ. [s3](#src-s3)

**Учебный пример результата, не реальный ответ Modelium:** если POST вернул `{"job_id":"job_example","status":"downloading"}`, в следующем запросе путь заканчивается на `/status/job_example`. Успех скачивания — ответ статуса с `"status":"completed"` и наличие нужного файла в списке моделей; само наличие `job_id` ещё ничего не доказывает. Каталожный пример может измениться, а неподходящая вашему компьютеру модель может не запуститься после скачивания. Для остановки *уже работающего* экземпляра есть [другая инструкция](/zhurnal/lm-studio-api-vygruzit-model/). [s1](#src-s1) [s2](#src-s2) [s3](#src-s3)

## Источники

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