查询下载进度

GET /v1/models/downloads

轮询下载任务,例如每秒一次。按 model 匹配条目;列表为空不代表已安装完成。失败时看 error,重试要重新发一次 POST。

指南与示例模型与服务全部接口

响应

200当前的下载任务。示例里的字节数只作说明。
objectstringlist
dataobject[]
modelstring
statestringdownloading | completed | failed | cancelled
bytes_downloadedinteger
total_bytesinteger0 可能只是总量还不知道。
errorstring | null
JSON
{
  "object": "list",
  "data": [
    {
      "model": "Qwen/Qwen3.5-4B",
      "state": "completed",
      "bytes_downloaded": 2500000000,
      "total_bytes": 2500000000,
      "error": null
    }
  ]
}
401API Key 缺失或无效。
403Host 或 Origin 不被允许,或 License 被拒。按 error.code 区分这两种情况。
503所需的本地模型仍在准备(model_downloading),或服务正忙(service_busy)。带 Retry-After 时按它退避。