下载模型 | LM Studio - LM Studio 应用程序

POST /api/v1/models/download

请求体

model : string

要下载的模型。接受模型目录标识符（例如，openai/gpt-oss-20b）和准确的 Hugging Face 链接（例如，https://hugging-face.cn/lmstudio-community/gpt-oss-20b-GGUF）

quantization (可选) : string

要下载的模型的量化级别（例如，Q4_K_M）。仅支持 Hugging Face 链接。

请求示例

curl https://:1234/api/v1/models/download \
  -H "Authorization: Bearer $LM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ibm/granite-4-micro"
  }'

响应字段

返回下载任务状态对象。响应因下载状态而异。

job_id (可选) : string

下载任务的唯一标识符。当 status 为 already_downloaded 时不存在。

status : "downloading" | "paused" | "completed" | "failed" | "already_downloaded"

下载的当前状态。

completed_at (可选) : string

采用 ISO 8601 格式的下载完成时间。当 status 为 completed 时存在。

total_size_bytes (可选) : number

下载的总大小（以字节为单位）。当 status 为 already_downloaded 时不存在。

started_at (可选) : string

采用 ISO 8601 格式的下载开始时间。当 status 为 already_downloaded 时不存在。

响应

{
  "job_id": "job_493c7c9ded",
  "status": "downloading",
  "total_size_bytes": 2279145003,
  "started_at": "2025-10-03T15:33:23.496Z"
}