List models

GET/api/models

Lists available models with optional filtering by query, provider, or keys.

Query Parameters

query?string

Filter models by name (case-insensitive partial match)

provider?string

Filter by specific provider name

keys?array<string>

Comma-separated list of key IDs to filter models accessible by those keys

limit?integer

Maximum number of results to return (default 5)

Default5

unfiltered?boolean

If true, return all models including those filtered out by provider-level restrictions

Defaultfalse

Response Body

`application/json`

curl -X GET "http://localhost:8080/api/models"

{
  "models": [
    {
      "name": "string",
      "provider": "string",
      "accessible_by_keys": [
        "string"
      ]
    }
  ],
  "total": 0
}

{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}

Query Parameters

Response Body

200application/json

500application/json

`application/json`

`application/json`