List Models

GET

models

curl https://gateway.bud.studio/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gateway.bud.studio/v1/models?kind=model&capability=chat" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "llama-3.2-1b",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["chat", "responses"]
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["embedding"]
    },
    {
      "id": "route-rag",
      "object": "model",
      "created": 1755254400,
      "owned_by": "bud",
      "kind": "router",
      "capabilities": ["chat"]
    }
  ]
}

Returns every alias the calling API key is authorized to use. The response follows the OpenAI List models shape, with two additional fields — kind and capabilities — that say what each alias actually is and what it can do.

curl https://gateway.bud.studio/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gateway.bud.studio/v1/models?kind=model&capability=chat" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "llama-3.2-1b",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["chat", "responses"]
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["embedding"]
    },
    {
      "id": "route-rag",
      "object": "model",
      "created": 1755254400,
      "owned_by": "bud",
      "kind": "router",
      "capabilities": ["chat"]
    }
  ]
}

Headers

Parameter	Type	Required	Description
Authorization	string	Yes	Bearer authentication header of the form `Bearer <token>` where `<token>` is your API key

Query Parameters

Both filters are optional. With neither, the full set is returned.

Parameter	Type	Required	Description
kind	string	No	Return only aliases of this kind. One of `model`, `adapter`, `guardrail`, `router`, `unknown`.
capability	string	No	Return only aliases supporting this capability, e.g. `chat`, `embedding`, `responses`, `moderation`.

An unrecognised value for either returns 400, listing the accepted values — it does not return an empty list.

Response Fields

Field	Type	Description
id	string	The alias to pass as `model` in a request body.
object	string	Always `"model"`. This is the resource type, telling a client which shape to deserialize — not what the alias is. Use `kind` for that.
created	integer	Unix timestamp (seconds) of when the underlying deployment was created. `0` when unknown.
owned_by	string	Always `"bud"`.
kind	string	What the alias is. See below.
capabilities	array	Endpoint capabilities the alias supports, sorted. Empty if the gateway could not resolve the alias’s backing configuration.

Kinds

Kind	Description
`model`	A deployed model endpoint. The common case.
`adapter`	A LoRA adapter served on top of a deployed model.
`guardrail`	A standalone guardrail deployment. Typically `moderation`-only — not usable for chat.
`router`	An inference router that dispatches across several models.
`unknown`	The gateway could not determine the kind. Treat as unroutable until confirmed.

Agents are not listed here. They are addressed through POST /v1/responses using prompt.id, or via the x-model-name header on the /v1/responses sub-resources. Passing ?kind=agent returns 400 with that guidance rather than an empty list.

Not every listed alias works with every endpoint. A guardrail alias supports moderation only, and an embedding model supports embedding only — sending either to /v1/chat/completions fails. Filter on capabilities before offering a list to users, or use ?capability=chat.

curl https://gateway.bud.studio/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gateway.bud.studio/v1/models?kind=model&capability=chat" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "llama-3.2-1b",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["chat", "responses"]
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1755168000,
      "owned_by": "bud",
      "kind": "model",
      "capabilities": ["embedding"]
    },
    {
      "id": "route-rag",
      "object": "model",
      "created": 1755254400,
      "owned_by": "bud",
      "kind": "router",
      "capabilities": ["chat"]
    }
  ]
}

Introduction

Gateway APIs

Python SDK & CLI

Headers

Query Parameters

Response Fields

Kinds

​Headers

​Query Parameters

​Response Fields

​Kinds

Headers

Query Parameters

Response Fields

Kinds