List available models

Lists available models. If provider is not specified, lists all models from all configured providers.

If a virtual key is provided, Bifrost only lists (and only queries) providers allowed by that virtual key.

GET /v1/models

Error

A valid request URL is required to generate request examples

200

{
  "data": [
    {
      "id": "<string>",
      "canonical_slug": "<string>",
      "name": "<string>",
      "normalized_name": "<string>",
      "deployment": "<string>",
      "created": 123,
      "context_length": 123,
      "max_input_tokens": 123,
      "max_output_tokens": 123,
      "architecture": {
        "modality": "<string>",
        "tokenizer": "<string>",
        "instruct_type": "<string>",
        "input_modalities": [
          "<string>"
        ],
        "output_modalities": [
          "<string>"
        ]
      },
      "pricing": {
        "prompt": "<string>",
        "completion": "<string>",
        "request": "<string>",
        "image": "<string>",
        "web_search": "<string>",
        "internal_reasoning": "<string>",
        "input_cache_read": "<string>",
        "input_cache_write": "<string>"
      },
      "top_provider": {
        "is_moderated": true,
        "context_length": 123,
        "max_completion_tokens": 123
      },
      "per_request_limits": {
        "prompt_tokens": 123,
        "completion_tokens": 123
      },
      "supported_parameters": [
        "<string>"
      ],
      "default_parameters": {
        "temperature": 123,
        "top_p": 123,
        "frequency_penalty": 123
      },
      "reasoning": {
        "mandatory": true,
        "default_enabled": true,
        "supported_efforts": [
          "<string>"
        ],
        "default_effort": "<string>"
      },
      "hugging_face_id": "<string>",
      "description": "<string>",
      "owned_by": "<string>",
      "supported_methods": [
        "<string>"
      ]
    }
  ],
  "extra_fields": {
    "request_type": "<string>",
    "pricing_request_type": "<string>",
    "routing_info": {
      "provider": "anthropic",
      "model": "<string>",
      "key": "<string>",
      "resolved_key_alias": {
        "model_id": "<string>",
        "model_name": "<string>",
        "model_family": "<string>"
      },
      "is_fallback": true,
      "primary_provider": "anthropic",
      "primary_model": "<string>",
      "requested_provider": "anthropic",
      "requested_model": "<string>",
      "server_side_fallback_model": "<string>"
    },
    "provider": "anthropic",
    "original_model_requested": "<string>",
    "resolved_model_used": "<string>",
    "latency": 123,
    "upstream_latency": 123,
    "chunk_index": 123,
    "raw_request": "<unknown>",
    "raw_response": "<unknown>",
    "cache_debug": {
      "cache_hit": true,
      "cache_id": "<string>",
      "hit_type": "<string>",
      "requested_provider": "<string>",
      "requested_model": "<string>",
      "provider_used": "<string>",
      "model_used": "<string>",
      "input_tokens": 123,
      "threshold": 123,
      "similarity": 123,
      "cache_hit_latency": 123
    },
    "routing_metadata": {
      "calls": [
        {
          "request_type": "<string>",
          "provider_used": "<string>",
          "model_used": "<string>",
          "input_tokens": 123,
          "output_tokens": 123,
          "count_toward_budgets": true
        }
      ]
    },
    "guardrail_debug": {
      "judge_calls": [
        {
          "phase": "<string>",
          "rule_id": 123,
          "rule_name": "<string>",
          "guardrail_name": "<string>",
          "guardrail_provider": "<string>",
          "action": "<string>",
          "reason": "<string>",
          "judge_provider": "<string>",
          "judge_model": "<string>",
          "judge_request_type": "<string>",
          "prompt_tokens": 123,
          "prompt_tokens_details": {},
          "completion_tokens": 123,
          "completion_tokens_details": {},
          "total_tokens": 123
        }
      ],
      "detections": [
        {
          "phase": "<string>",
          "rule_id": 123,
          "rule_name": "<string>",
          "guardrail_name": "<string>",
          "guardrail_provider": "<string>",
          "reason": "<string>",
          "assessments": [
            "<string>"
          ],
          "action": "detect",
          "enforced": true
        }
      ]
    },
    "parse_errors": [
      {
        "code": "<string>",
        "message": "<string>",
        "param": "<string>",
        "line": 123
      }
    ],
    "converted_request_type": "<string>",
    "dropped_compat_plugin_params": [
      "<string>"
    ],
    "dropped_unsupported_tools": [
      "<string>"
    ],
    "provider_response_headers": {},
    "passthrough_path": "<string>"
  },
  "next_page_token": "<string>"
}

Authorizations

BearerAuthVirtualKeyAuthApiKeyAuth

Authorization · string · header · required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

Query Parameters

provider · enum<string>

Filter by provider (e.g., openai, anthropic, bedrock) AI model provider identifier

Available options: anthropic, azure, bedrock, bedrock_mantle, cerebras, cohere, deepseek, gemini, groq, mistral, ollama, opencode-go, opencode-zen, openai, parasail, perplexity, sgl, vertex, openrouter, elevenlabs, huggingface, nebius, xai, replicate, vllm, runway, runware, fireworks, sarvam, wafer, databricks, cloudflare, typesafe

page_size · integer

Maximum number of models to return

Required range: x >= 0

page_token · string

Token for pagination

Response

200

application/json

Successful response

data · object[]

Show child attributes

extra_fields · object

Additional fields included in responses

Show child attributes

next_page_token · string