开始下载模型
POST /v1/models/download
在服务所在机器上启动后台下载任务,返回 202 Accepted,不代表模型已就绪。下载会占用网络带宽和磁盘空间。内置的 EdgeSpeak/Skylark 直接可用,没有下载、加载、卸载这套生命周期。加载前先轮询 GET /v1/models/downloads。
请求体
application/json必填
modelstring必填清单里的模型 ID。响应
202下载任务已受理。total_bytes: 0 可能只是总量还不知道。modelstringstatestringbytes_downloadedintegertotal_bytesinteger0 可能只是总量还不知道。errorstring | null{
"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 时按它退避。