Skip to main content
GET
/
api
/
governance
/
virtual-keys
/
quota
Error
A valid request URL is required to generate request examples
{
  "virtual_key_name": "<string>",
  "is_active": true,
  "budgets": [
    {
      "id": "<string>",
      "max_limit": 123,
      "reset_duration": "<string>",
      "last_reset": "2023-11-07T05:31:56Z",
      "current_usage": 123,
      "config_hash": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "calendar_aligned": false,
      "team_id": "<string>",
      "virtual_key_id": "<string>",
      "provider_config_id": 123
    }
  ],
  "rate_limit": {
    "id": "<string>",
    "token_current_usage": 123,
    "token_last_reset": "2023-11-07T05:31:56Z",
    "request_current_usage": 123,
    "request_last_reset": "2023-11-07T05:31:56Z",
    "config_hash": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "token_max_limit": 123,
    "token_reset_duration": "<string>",
    "request_max_limit": 123,
    "request_reset_duration": "<string>"
  },
  "provider_configs": [
    {
      "id": 123,
      "virtual_key_id": "<string>",
      "provider": "<string>",
      "weight": 123,
      "allowed_models": [
        "<string>"
      ],
      "blacklisted_models": [
        "<string>"
      ],
      "allow_all_keys": true,
      "keys": [
        {
          "id": 123,
          "name": "<string>",
          "provider_id": 123,
          "provider": "<string>",
          "key_id": "<string>",
          "value": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "models": [
            "<string>"
          ],
          "weight": 123,
          "enabled": true,
          "use_for_batch_api": false,
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "config_hash": "<string>",
          "azure_endpoint": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "azure_client_id": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "azure_client_secret": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "azure_tenant_id": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "vertex_project_id": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "vertex_project_number": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "vertex_region": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "vertex_auth_credentials": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "bedrock_access_key": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "bedrock_secret_key": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "bedrock_session_token": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "bedrock_region": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          },
          "bedrock_arn": {
            "value": "<string>",
            "env_var": "<string>",
            "from_env": true
          }
        }
      ],
      "rate_limit_id": "<string>",
      "budgets": [
        {
          "id": "<string>",
          "max_limit": 123,
          "reset_duration": "<string>",
          "last_reset": "2023-11-07T05:31:56Z",
          "current_usage": 123,
          "config_hash": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "calendar_aligned": false,
          "team_id": "<string>",
          "virtual_key_id": "<string>",
          "provider_config_id": 123
        }
      ],
      "rate_limit": {
        "id": "<string>",
        "token_current_usage": 123,
        "token_last_reset": "2023-11-07T05:31:56Z",
        "request_current_usage": 123,
        "request_last_reset": "2023-11-07T05:31:56Z",
        "config_hash": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "token_max_limit": 123,
        "token_reset_duration": "<string>",
        "request_max_limit": 123,
        "request_reset_duration": "<string>"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.getbifrost.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-bf-vk
string
header
required

Bifrost Virtual Key for governance, routing, and access control. Supported on all inference endpoints (/v1/*, /openai/*, /anthropic/*, /bedrock/*, /cohere/*, /genai/*, /langchain/*, /litellm/*, /pydanticai/*, /mcp), not on management APIs (/api/*). Example: sk-bf-* prefixed keys.

Response

Successful response

Virtual key quota response (self-service, no admin auth required)

virtual_key_name
string
required

Name of the virtual key

is_active
boolean
required

Whether the virtual key is active

budgets
object[] | null
required

Overall budget quotas assigned to this virtual key

rate_limit
object
required

Rate limit configuration

provider_configs
object[] | null
required

Per-provider budget quotas and rate limits (provider-level splits and limits)