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"
}

下载模型