Cancel an active download

POST /v1/models/download/cancel

Cancels a currently active download job. Cancellation is asynchronous; poll GET /v1/models/downloads until the job reaches a terminal state.

Guide and examplesModels and serviceAll endpoints

Request body

application/jsonRequired

modelstringRequiredCatalog model ID.

Responses

200The cancellation was accepted.
modelstring
statestringcancelling while the asynchronous cancellation runs.
JSON
{
  "model": "Qwen/Qwen3.5-4B",
  "state": "cancelling"
}
400Invalid request. Fix the request before retrying; use error.code for program logic and error.param to locate the input.
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.