开始下载模型

POST /v1/models/download

在服务所在机器上启动后台下载任务,返回 202 Accepted,不代表模型已就绪。下载会占用网络带宽和磁盘空间。内置的 EdgeSpeak/Skylark 直接可用,没有下载、加载、卸载这套生命周期。加载前先轮询 GET /v1/models/downloads。

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

请求体

application/json必填

modelstring必填清单里的模型 ID。

响应

202下载任务已受理。total_bytes: 0 可能只是总量还不知道。
modelstring
statestringdownloading | completed | failed | cancelled
bytes_downloadedinteger
total_bytesinteger0 可能只是总量还不知道。
errorstring | null
JSON
{
  "model": "Qwen/Qwen3.5-4B",
  "state": "downloading",
  "bytes_downloaded": 0,
  "total_bytes": 0,
  "error": null
}
400请求不合法。先改请求再重试:error.code 用于程序判断,error.param 用于定位是哪个输入。
401API Key 缺失或无效。
403Host 或 Origin 不被允许,或 License 被拒。按 error.code 区分这两种情况。
503所需的本地模型仍在准备(model_downloading),或服务正忙(service_busy)。带 Retry-After 时按它退避。