Skip to main content
GET
/
{ownerName}
/
{modelName}
/
requests
/
{requestId}
/
status
Get Request Status
curl --request GET \
  --url https://queue.modelrunner.run/{ownerName}/{modelName}/requests/{requestId}/status \
  --header 'Authorization: <api-key>'
{
  "request_id": "<string>",
  "response_url": "<string>",
  "status_url": "<string>",
  "cancel_url": "<string>",
  "logs": "<string>",
  "metrics": {
    "inference_time": 123
  },
  "queue_position": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.modelrunner.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use the format: Key modelrunner_key

Path Parameters

​
ownerName
string
default:bytedance
required

Model owner or organization name.

​
modelName
string
default:sdxl-lightning-4step
required

Model alias on ModelRunner.

​
requestId
string
required

The request identifier returned by Create Request.

Required string length: 21

Response

Current request status

​
status
enum<string>
required
Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELLED
​
request_id
string
required
Required string length: 21
​
response_url
string<uri>
required
​
status_url
string<uri>
required
​
cancel_url
string<uri>
required
​
logs
string
​
metrics
object
​
queue_position
number