Check download progress

GET /v1/models/downloads

Polls download jobs, for example once per second. Match the entry by model; an empty list does not prove installation. On failure inspect error, and retry with an explicit new POST.

Guide and examplesModels and serviceAll endpoints

Responses

200Current download jobs. Byte counts in the example are illustrative.
objectstringlist
dataobject[]
modelstring
statestringdownloading | completed | failed | cancelled
bytes_downloadedinteger
total_bytesinteger0 can mean the total is not known yet.
errorstring | null
JSON
{
  "object": "list",
  "data": [
    {
      "model": "Qwen/Qwen3.5-4B",
      "state": "completed",
      "bytes_downloaded": 2500000000,
      "total_bytes": 2500000000,
      "error": null
    }
  ]
}
401Invalid or missing API key.
403Host or origin is not allowed, or the license was rejected. Inspect error.code to tell them apart.
503A required local model is still being prepared (model_downloading) or the service is busy (service_busy). Honor Retry-After when present.