List models

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

GET
/api/models
AuthorizationBearer <token>

Bearer token authentication. Use your MPilot virtual-key JWT or admin JWT. Virtual keys (prefixed with sk-bf-) can also be passed here.

In: header

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

curl -X GET "https://loading/{AI_GATEWAY_URL}/api/models?query=string&provider=string&keys=string&limit=5&unfiltered=false"
{
  "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"
  }
}
On this page

On this page

No Headings