GET
/
models
/
v2
/
{modelId}
READ cluster
curl --request GET \
  --url https://api.bytez.com/models/v2/{modelId} \
  --header 'Authorization: <api-key>'
{
  "error": null,
  "output": {
    "modelId": "stabilityai/stable-diffusion-xl-base-1.0",
    "status": "booting instance",
    "created": "2025-04-22T17:57:40.036Z",
    "modified": "2025-04-22T17:57:58.638Z",
    "timeout": 5,
    "capacity": {
      "min": 0,
      "desired": 1,
      "max": 1
    },
    "instances": 1,
    "inferences": 0,
    "lastInference": "2025-04-22T17:57:40.036Z"
  }
}

Authorizations

​
Authorization
string
header
required

Set Authorization header to Key BYTEZ_KEY (e.g. 'Authorization': 'Key ABC123')

Path Parameters

​
modelId
string
required

The model you want to run (e.g., openai-community/gpt2).

Response

200
application/json

Cluster information retrieved successfully.

The response is of type object.