API reference / Queue

Status

llms-full.txt

GEThttps://api.minicut.ai/v1/queue/{model_id}/requests/{request_id}/status

Status of a request

Path

model_idstringrequired

Model id, for example seedance-2.5

request_idstringrequired

Response 200

statusstring

IN_QUEUEIN_PROGRESSCOMPLETED

statestring

queuedin_progresscompletedfailedcancelledexpired

queue_positioninteger or null

Your jobs ahead of this one in line, while it waits. 0 is next to start

response_urlstring, url

logsarray

metricsobject

metrics.inference_timenumber or null

errorobject or null

curl "https://api.minicut.ai/v1/queue/seedance-2.5/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MINIAPI_KEY"

Response 200

{
  "status": "IN_PROGRESS",
  "state": "in_progress",
  "queue_position": null,
  "response_url": "https://api.minicut.ai/v1/queue/seedance-2.5/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "logs": [],
  "metrics": {},
  "error": null
}

401missing_api_key No Authorization header

401invalid_api_key Wrong, unknown or revoked key

404request_not_found No request of yours has that id

429rate_limited Too many requests; wait for Retry-After

500internal_error Our side; try again