2024-07-17 08:15:20 +08:00
import os
import sys
2023-11-24 12:27:44 +08:00
import traceback
2024-05-03 03:24:49 +08:00
from unittest import mock
2024-07-17 08:15:20 +08:00
2023-11-24 12:27:44 +08:00
from dotenv import load_dotenv
2024-07-17 08:15:20 +08:00
import litellm . proxy
import litellm . proxy . proxy_server
2023-11-24 12:27:44 +08:00
load_dotenv ( )
2024-07-17 08:15:20 +08:00
import io
2024-12-13 10:43:17 +08:00
import json
2024-07-17 08:15:20 +08:00
import os
2023-11-24 12:27:44 +08:00
# this file is to test litellm/proxy
sys . path . insert (
0 , os . path . abspath ( " ../.. " )
2023-12-25 16:40:38 +08:00
) # Adds the parent directory to the system path
2024-07-17 08:15:20 +08:00
import asyncio
import logging
import pytest
2023-11-24 12:27:44 +08:00
import litellm
2024-07-17 08:15:20 +08:00
from litellm import RateLimitError , Timeout , completion , completion_cost , embedding
2023-12-25 16:40:38 +08:00
2023-12-07 09:40:38 +08:00
# Configure logging
logging . basicConfig (
level = logging . DEBUG , # Set the desired logging level
format = " %(asctime)s - %(levelname)s - %(message)s " ,
)
2023-11-24 12:27:44 +08:00
2026-06-05 05:56:02 +08:00
from unittest . mock import AsyncMock , MagicMock , patch
2024-07-17 08:15:20 +08:00
from fastapi import FastAPI
2023-11-24 12:27:44 +08:00
# test /chat/completion request to the proxy
from fastapi . testclient import TestClient
2024-07-17 08:15:20 +08:00
from litellm . integrations . custom_logger import CustomLogger
from litellm . proxy . proxy_server import ( # Replace with the actual module where your FastAPI router is defined
2024-06-16 06:09:49 +08:00
app ,
2023-12-25 16:40:38 +08:00
initialize ,
2024-07-17 08:15:20 +08:00
save_worker_config ,
)
from litellm . proxy . utils import ProxyLogging
2023-12-06 03:13:09 +08:00
2023-12-07 10:38:44 +08:00
# Your bearer token
2024-01-27 12:15:35 +08:00
token = " sk-1234 "
2023-12-07 10:38:44 +08:00
2023-12-25 16:40:38 +08:00
headers = { " Authorization " : f " Bearer { token } " }
2024-05-03 03:47:27 +08:00
example_completion_result = {
" choices " : [
{
" message " : {
" content " : " Whispers of the wind carry dreams to me. " ,
2024-06-02 18:49:34 +08:00
" role " : " assistant " ,
2024-05-03 03:47:27 +08:00
}
}
] ,
}
2024-05-03 04:36:23 +08:00
example_embedding_result = {
2024-06-02 18:49:34 +08:00
" object " : " list " ,
" data " : [
{
" object " : " embedding " ,
" index " : 0 ,
" embedding " : [
- 0.006929283495992422 ,
- 0.005336422007530928 ,
- 4.547132266452536e-05 ,
- 0.024047505110502243 ,
- 0.006929283495992422 ,
- 0.005336422007530928 ,
- 4.547132266452536e-05 ,
- 0.024047505110502243 ,
- 0.006929283495992422 ,
- 0.005336422007530928 ,
- 4.547132266452536e-05 ,
- 0.024047505110502243 ,
] ,
}
] ,
" model " : " text-embedding-3-small " ,
" usage " : { " prompt_tokens " : 5 , " total_tokens " : 5 } ,
2024-05-03 04:36:23 +08:00
}
example_image_generation_result = {
2024-06-02 18:49:34 +08:00
" created " : 1589478378 ,
" data " : [ { " url " : " https://... " } , { " url " : " https://... " } ] ,
2024-05-03 04:36:23 +08:00
}
2024-05-03 03:47:27 +08:00
2023-12-25 16:40:38 +08:00
2024-05-03 03:24:49 +08:00
def mock_patch_acompletion ( ) :
2024-05-03 04:36:23 +08:00
return mock . patch (
2024-05-03 03:24:49 +08:00
" litellm.proxy.proxy_server.llm_router.acompletion " ,
2024-05-03 03:47:27 +08:00
return_value = example_completion_result ,
2024-05-03 04:36:23 +08:00
)
def mock_patch_aembedding ( ) :
return mock . patch (
" litellm.proxy.proxy_server.llm_router.aembedding " ,
return_value = example_embedding_result ,
)
def mock_patch_aimage_generation ( ) :
return mock . patch (
" litellm.proxy.proxy_server.llm_router.aimage_generation " ,
return_value = example_image_generation_result ,
)
2024-05-03 03:24:49 +08:00
2023-12-12 13:30:02 +08:00
@pytest.fixture ( scope = " function " )
Set fake env vars for `client_no_auth` fixture
This allows all of the tests in `test_proxy_server.py` to pass, with the
exception of `test_load_router_config`, without needing to set up real
environment variables.
Before:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
...
========================================================== short test summary info ===========================================================
ERROR litellm/tests/test_proxy_server.py::test_bedrock_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_optional_params - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_engines_model_chat_completions - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_health - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_img_gen - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_openai_deployments_model_chat_completions_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
========================================== 2 skipped, 1 deselected, 39 warnings, 9 errors in 3.24s ===========================================
```
After:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
============================================================ test session starts =============================================================
platform darwin -- Python 3.12.3, pytest-7.4.4, pluggy-1.5.0
rootdir: /Users/abramowi/Code/OpenSource/litellm
plugins: anyio-4.3.0, asyncio-0.23.6, mock-3.14.0
asyncio: mode=Mode.STRICT
collected 12 items / 1 deselected / 11 selected
litellm/tests/test_proxy_server.py s.........s [100%]
========================================== 9 passed, 2 skipped, 1 deselected, 48 warnings in 8.42s ===========================================
```
2024-05-12 06:22:30 +08:00
def fake_env_vars ( monkeypatch ) :
# Set some fake environment variables
monkeypatch . setenv ( " OPENAI_API_KEY " , " fake_openai_api_key " )
monkeypatch . setenv ( " OPENAI_API_BASE " , " http://fake-openai-api-base " )
2026-03-29 10:17:38 +08:00
monkeypatch . setenv ( " AZURE_AI_API_BASE " , " http://fake-azure-api-base " )
Set fake env vars for `client_no_auth` fixture
This allows all of the tests in `test_proxy_server.py` to pass, with the
exception of `test_load_router_config`, without needing to set up real
environment variables.
Before:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
...
========================================================== short test summary info ===========================================================
ERROR litellm/tests/test_proxy_server.py::test_bedrock_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_optional_params - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_engines_model_chat_completions - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_health - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_img_gen - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_openai_deployments_model_chat_completions_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
========================================== 2 skipped, 1 deselected, 39 warnings, 9 errors in 3.24s ===========================================
```
After:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
============================================================ test session starts =============================================================
platform darwin -- Python 3.12.3, pytest-7.4.4, pluggy-1.5.0
rootdir: /Users/abramowi/Code/OpenSource/litellm
plugins: anyio-4.3.0, asyncio-0.23.6, mock-3.14.0
asyncio: mode=Mode.STRICT
collected 12 items / 1 deselected / 11 selected
litellm/tests/test_proxy_server.py s.........s [100%]
========================================== 9 passed, 2 skipped, 1 deselected, 48 warnings in 8.42s ===========================================
```
2024-05-12 06:22:30 +08:00
monkeypatch . setenv ( " AZURE_OPENAI_API_KEY " , " fake_azure_openai_api_key " )
monkeypatch . setenv ( " AZURE_SWEDEN_API_BASE " , " http://fake-azure-sweden-api-base " )
2024-05-12 07:55:57 +08:00
monkeypatch . setenv ( " REDIS_HOST " , " localhost " )
Set fake env vars for `client_no_auth` fixture
This allows all of the tests in `test_proxy_server.py` to pass, with the
exception of `test_load_router_config`, without needing to set up real
environment variables.
Before:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
...
========================================================== short test summary info ===========================================================
ERROR litellm/tests/test_proxy_server.py::test_bedrock_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_chat_completion_optional_params - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_embedding - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_engines_model_chat_completions - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_health - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_img_gen - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
ERROR litellm/tests/test_proxy_server.py::test_openai_deployments_model_chat_completions_azure - openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY enviro...
========================================== 2 skipped, 1 deselected, 39 warnings, 9 errors in 3.24s ===========================================
```
After:
```shell
$ env -i PATH=$PATH poetry run pytest litellm/tests/test_proxy_server.py -k 'not test_load_router_config' --disable-warnings
============================================================ test session starts =============================================================
platform darwin -- Python 3.12.3, pytest-7.4.4, pluggy-1.5.0
rootdir: /Users/abramowi/Code/OpenSource/litellm
plugins: anyio-4.3.0, asyncio-0.23.6, mock-3.14.0
asyncio: mode=Mode.STRICT
collected 12 items / 1 deselected / 11 selected
litellm/tests/test_proxy_server.py s.........s [100%]
========================================== 9 passed, 2 skipped, 1 deselected, 48 warnings in 8.42s ===========================================
```
2024-05-12 06:22:30 +08:00
@pytest.fixture ( scope = " function " )
def client_no_auth ( fake_env_vars ) :
2023-12-12 14:11:11 +08:00
# Assuming litellm.proxy.proxy_server is an object
from litellm . proxy . proxy_server import cleanup_router_config_variables
2023-12-25 16:40:38 +08:00
2023-12-12 14:11:11 +08:00
cleanup_router_config_variables ( )
2023-12-12 09:57:58 +08:00
filepath = os . path . dirname ( os . path . abspath ( __file__ ) )
2023-12-12 13:30:02 +08:00
config_fp = f " { filepath } /test_configs/test_config_no_auth.yaml "
2023-12-12 12:03:01 +08:00
# initialize can get run in parallel, it sets specific variables for the fast api app, sinc eit gets run in parallel different tests use the wrong variables
2024-01-04 20:58:18 +08:00
asyncio . run ( initialize ( config = config_fp , debug = True ) )
2023-12-12 09:57:58 +08:00
return TestClient ( app )
2023-12-25 16:40:38 +08:00
2024-05-03 04:36:23 +08:00
@mock_patch_acompletion ( )
def test_chat_completion ( mock_acompletion , client_no_auth ) :
2023-12-07 10:38:44 +08:00
global headers
2023-11-24 12:27:44 +08:00
try :
# Your test data
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
2023-12-25 16:40:38 +08:00
{ " role " : " user " , " content " : " hi " } ,
2023-11-24 12:27:44 +08:00
] ,
" max_tokens " : 10 ,
}
2023-12-25 16:40:38 +08:00
2023-12-12 14:11:11 +08:00
print ( " testing proxy server with chat completions " )
2023-12-12 13:30:02 +08:00
response = client_no_auth . post ( " /v1/chat/completions " , json = test_data )
2024-05-03 04:36:23 +08:00
mock_acompletion . assert_called_once_with (
model = " gpt-3.5-turbo " ,
messages = [
{ " role " : " user " , " content " : " hi " } ,
] ,
max_tokens = 10 ,
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
specific_deployment = True ,
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-12-06 03:13:09 +08:00
print ( f " response - { response . text } " )
2023-11-24 12:27:44 +08:00
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
except Exception as e :
2023-12-06 03:13:09 +08:00
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2024-10-16 22:32:06 +08:00
2025-12-01 12:51:44 +08:00
def test_chat_completion_malformed_messages_returns_400 ( client_no_auth ) :
"""
Test that malformed messages ( strings instead of dicts ) return 400 instead of 500.
2026-03-29 10:17:38 +08:00
2025-12-01 12:51:44 +08:00
This test verifies that when a client sends messages as raw strings instead of
{ role , content } objects , LiteLLM returns a 400 invalid_request_error instead
of a 500 Internal Server Error .
"""
global headers
try :
# Test data with malformed messages (string instead of dict)
test_data = {
" model " : " gpt-3.5-turbo " ,
2026-03-29 10:17:38 +08:00
" messages " : [
" hi how are you "
] , # Invalid: should be [{"role": "user", "content": "hi how are you"}]
2025-12-01 12:51:44 +08:00
}
print ( " testing proxy server with malformed messages " )
2026-03-29 10:17:38 +08:00
response = client_no_auth . post (
" /v1/chat/completions " , json = test_data , headers = headers
)
2025-12-01 12:51:44 +08:00
print ( f " response status: { response . status_code } " )
print ( f " response text: { response . text } " )
2026-03-29 10:17:38 +08:00
2025-12-01 12:51:44 +08:00
# Should return 400, not 500
2026-03-29 10:17:38 +08:00
assert (
response . status_code == 400
) , f " Expected 400, got { response . status_code } . Response: { response . text } "
2025-12-01 12:51:44 +08:00
# Verify error format
result = response . json ( )
assert " error " in result , " Response should contain ' error ' key "
error = result [ " error " ]
2026-03-29 10:17:38 +08:00
2025-12-01 12:51:44 +08:00
# Verify error type and message
2026-03-29 10:17:38 +08:00
assert (
error . get ( " type " ) == " invalid_request_error " or error . get ( " type " ) is None
) , f " Expected invalid_request_error or None, got { error . get ( ' type ' ) } "
assert (
error . get ( " code " ) == " 400 " or error . get ( " code " ) == 400
) , f " Expected code 400, got { error . get ( ' code ' ) } "
2025-12-01 12:51:44 +08:00
# Error message should indicate invalid request format
error_message = error . get ( " message " , " " )
assert len ( error_message ) > 0 , " Error message should not be empty "
2026-03-29 10:17:38 +08:00
2025-12-01 12:51:44 +08:00
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2024-10-23 16:39:35 +08:00
def test_get_settings_request_timeout ( client_no_auth ) :
"""
When no timeout is set , it should use the litellm . request_timeout value
"""
# Set a known value for litellm.request_timeout
import litellm
# Make a GET request to /settings
response = client_no_auth . get ( " /settings " )
# Check if the request was successful
assert response . status_code == 200
# Parse the JSON response
settings = response . json ( )
print ( " settings " , settings )
assert settings [ " litellm.request_timeout " ] == litellm . request_timeout
2024-10-16 22:32:06 +08:00
@pytest.mark.parametrize (
" litellm_key_header_name " ,
[ " x-litellm-key " , None ] ,
)
def test_add_headers_to_request ( litellm_key_header_name ) :
from fastapi import Request
from starlette . datastructures import URL
import json
from litellm . proxy . litellm_pre_call_utils import (
clean_headers ,
2024-10-25 13:03:16 +08:00
LiteLLMProxyRequestSetup ,
2024-10-16 22:32:06 +08:00
)
headers = {
" Authorization " : " Bearer 1234 " ,
" X-Custom-Header " : " Custom-Value " ,
" X-Stainless-Header " : " Stainless-Value " ,
2025-07-10 12:46:15 +08:00
" anthropic-beta " : " beta-value " ,
2024-10-16 22:32:06 +08:00
}
request = Request ( scope = { " type " : " http " } )
request . _url = URL ( url = " /chat/completions " )
request . _body = json . dumps ( { " model " : " gpt-3.5-turbo " } ) . encode ( " utf-8 " )
request_headers = clean_headers ( headers , litellm_key_header_name )
2024-10-25 13:03:16 +08:00
forwarded_headers = LiteLLMProxyRequestSetup . _get_forwardable_headers (
request_headers
)
2025-07-10 12:46:15 +08:00
assert forwarded_headers == {
" X-Custom-Header " : " Custom-Value " ,
" anthropic-beta " : " beta-value " ,
}
2024-10-16 22:32:06 +08:00
@pytest.mark.parametrize (
" litellm_key_header_name " ,
[ " x-litellm-key " , None ] ,
)
2024-10-26 06:55:56 +08:00
@pytest.mark.parametrize (
" forward_headers " ,
[ True , False ] ,
)
2024-10-16 22:32:06 +08:00
@mock_patch_acompletion ( )
def test_chat_completion_forward_headers (
2024-10-26 06:55:56 +08:00
mock_acompletion , client_no_auth , litellm_key_header_name , forward_headers
2024-10-16 22:32:06 +08:00
) :
global headers
try :
2024-10-26 06:55:56 +08:00
if forward_headers :
gs = getattr ( litellm . proxy . proxy_server , " general_settings " )
gs [ " forward_client_headers_to_llm_api " ] = True
setattr ( litellm . proxy . proxy_server , " general_settings " , gs )
2024-10-16 22:32:06 +08:00
if litellm_key_header_name is not None :
gs = getattr ( litellm . proxy . proxy_server , " general_settings " )
gs [ " litellm_key_header_name " ] = litellm_key_header_name
setattr ( litellm . proxy . proxy_server , " general_settings " , gs )
# Your test data
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
{ " role " : " user " , " content " : " hi " } ,
] ,
" max_tokens " : 10 ,
}
headers_to_forward = {
" X-Custom-Header " : " Custom-Value " ,
" X-Another-Header " : " Another-Value " ,
}
if litellm_key_header_name is not None :
headers_to_not_forward = { litellm_key_header_name : " Bearer 1234 " }
else :
headers_to_not_forward = { " Authorization " : " Bearer 1234 " }
received_headers = { * * headers_to_forward , * * headers_to_not_forward }
print ( " testing proxy server with chat completions " )
response = client_no_auth . post (
" /v1/chat/completions " , json = test_data , headers = received_headers
)
2024-10-26 06:55:56 +08:00
if not forward_headers :
assert " headers " not in mock_acompletion . call_args . kwargs
else :
assert mock_acompletion . call_args . kwargs [ " headers " ] == {
2024-10-16 22:32:06 +08:00
" x-custom-header " : " Custom-Value " ,
" x-another-header " : " Another-Value " ,
2024-10-26 06:55:56 +08:00
}
2024-10-16 22:32:06 +08:00
print ( f " response - { response . text } " )
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-11-24 12:27:44 +08:00
2023-12-25 16:40:38 +08:00
2026-02-25 14:38:25 +08:00
@pytest.mark.parametrize ( " forward_llm_auth_headers " , [ True , False ] )
@mock_patch_acompletion ( )
def test_chat_completion_forward_llm_provider_auth_headers (
mock_acompletion , client_no_auth , forward_llm_auth_headers
) :
"""
Test that LLM provider auth headers ( x - api - key , x - goog - api - key ) are forwarded
when forward_llm_provider_auth_headers = True .
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
This allows clients to send their own LLM provider API keys through the proxy .
"""
try :
# Configure general settings
gs = getattr ( litellm . proxy . proxy_server , " general_settings " )
gs [ " forward_client_headers_to_llm_api " ] = True
gs [ " forward_llm_provider_auth_headers " ] = forward_llm_auth_headers
setattr ( litellm . proxy . proxy_server , " general_settings " , gs )
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Test data
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
{ " role " : " user " , " content " : " hello " } ,
] ,
" max_tokens " : 10 ,
}
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Headers including LLM provider auth
request_headers = {
" Authorization " : " Bearer sk-proxy-auth-123 " , # Proxy auth (should be stripped)
" x-api-key " : " sk-ant-api03-test-anthropic-key " , # Anthropic API key
" x-goog-api-key " : " google-api-key-123 " , # Google API key
" X-Custom-Header " : " custom-value " , # Custom header (should be forwarded)
}
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Make request
response = client_no_auth . post (
" /v1/chat/completions " , json = test_data , headers = request_headers
)
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
assert response . status_code == 200
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Check forwarded headers
forwarded_headers = mock_acompletion . call_args . kwargs . get ( " headers " , { } )
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
if forward_llm_auth_headers :
# LLM provider auth headers should be forwarded
assert " x-api-key " in forwarded_headers
assert forwarded_headers [ " x-api-key " ] == " sk-ant-api03-test-anthropic-key "
assert " x-goog-api-key " in forwarded_headers
assert forwarded_headers [ " x-goog-api-key " ] == " google-api-key-123 "
else :
# LLM provider auth headers should be stripped
assert " x-api-key " not in forwarded_headers
assert " x-goog-api-key " not in forwarded_headers
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Custom headers should always be forwarded (when forward_client_headers_to_llm_api=True)
assert " x-custom-header " in forwarded_headers
assert forwarded_headers [ " x-custom-header " ] == " custom-value "
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
# Proxy Authorization should never be forwarded
assert " authorization " not in forwarded_headers
2026-03-29 10:17:38 +08:00
print (
f " ✓ Test passed with forward_llm_provider_auth_headers= { forward_llm_auth_headers } "
)
2026-02-25 14:38:25 +08:00
print ( f " Forwarded headers: { list ( forwarded_headers . keys ( ) ) } " )
2026-03-29 10:17:38 +08:00
2026-02-25 14:38:25 +08:00
except Exception as e :
2026-03-29 10:17:38 +08:00
pytest . fail (
f " Test failed with forward_llm_auth_headers= { forward_llm_auth_headers } : { str ( e ) } "
)
2026-02-25 14:38:25 +08:00
finally :
# Clean up
gs = getattr ( litellm . proxy . proxy_server , " general_settings " )
gs . pop ( " forward_llm_provider_auth_headers " , None )
setattr ( litellm . proxy . proxy_server , " general_settings " , gs )
2024-07-21 09:39:05 +08:00
@mock_patch_acompletion ( )
@pytest.mark.asyncio
async def test_team_disable_guardrails ( mock_acompletion , client_no_auth ) :
"""
If team not allowed to turn on / off guardrails
Raise 403 forbidden error , if request is made by team on ` / key / generate ` or ` / chat / completions ` .
"""
import asyncio
import json
import time
from fastapi import HTTPException , Request
from starlette . datastructures import URL
2024-08-01 02:49:07 +08:00
from litellm . proxy . _types import (
LiteLLM_TeamTable ,
LiteLLM_TeamTableCachedObj ,
ProxyException ,
UserAPIKeyAuth ,
)
2024-07-21 09:39:05 +08:00
from litellm . proxy . auth . user_api_key_auth import user_api_key_auth
from litellm . proxy . proxy_server import hash_token , user_api_key_cache
_team_id = " 1234 "
user_key = " sk-12345678 "
valid_token = UserAPIKeyAuth (
team_id = _team_id ,
team_blocked = True ,
token = hash_token ( user_key ) ,
last_refreshed_at = time . time ( ) ,
)
await asyncio . sleep ( 1 )
2024-08-01 02:49:07 +08:00
team_obj = LiteLLM_TeamTableCachedObj (
2024-07-21 09:39:05 +08:00
team_id = _team_id ,
blocked = False ,
last_refreshed_at = time . time ( ) ,
metadata = { " guardrails " : { " modify_guardrails " : False } } ,
)
user_api_key_cache . set_cache ( key = hash_token ( user_key ) , value = valid_token )
user_api_key_cache . set_cache ( key = " team_id: {} " . format ( _team_id ) , value = team_obj )
setattr ( litellm . proxy . proxy_server , " user_api_key_cache " , user_api_key_cache )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
setattr ( litellm . proxy . proxy_server , " prisma_client " , " hello-world " )
request = Request ( scope = { " type " : " http " } )
request . _url = URL ( url = " /chat/completions " )
body = { " metadata " : { " guardrails " : { " hide_secrets " : False } } }
json_bytes = json . dumps ( body ) . encode ( " utf-8 " )
request . _body = json_bytes
try :
await user_api_key_auth ( request = request , api_key = " Bearer " + user_key )
pytest . fail ( " Expected to raise 403 forbidden error. " )
except ProxyException as e :
2024-08-01 02:49:07 +08:00
assert e . code == str ( 403 )
2024-07-21 09:39:05 +08:00
2024-10-02 01:49:22 +08:00
from test_custom_callback_input import CompletionCustomHandler
2024-07-17 08:15:20 +08:00
@mock_patch_acompletion ( )
def test_custom_logger_failure_handler ( mock_acompletion , client_no_auth ) :
from litellm . proxy . _types import UserAPIKeyAuth
from litellm . proxy . proxy_server import hash_token , user_api_key_cache
rpm_limit = 0
mock_api_key = " sk-my-test-key "
cache_value = UserAPIKeyAuth ( token = hash_token ( mock_api_key ) , rpm_limit = rpm_limit )
user_api_key_cache . set_cache ( key = hash_token ( mock_api_key ) , value = cache_value )
mock_logger = CustomLogger ( )
mock_logger_unit_tests = CompletionCustomHandler ( )
proxy_logging_obj : ProxyLogging = getattr (
litellm . proxy . proxy_server , " proxy_logging_obj "
)
litellm . callbacks = [ mock_logger , mock_logger_unit_tests ]
proxy_logging_obj . _init_litellm_callbacks ( llm_router = None )
setattr ( litellm . proxy . proxy_server , " user_api_key_cache " , user_api_key_cache )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
setattr ( litellm . proxy . proxy_server , " prisma_client " , " FAKE-VAR " )
setattr ( litellm . proxy . proxy_server , " proxy_logging_obj " , proxy_logging_obj )
with patch . object (
mock_logger , " async_log_failure_event " , new = AsyncMock ( )
) as mock_failed_alert :
# Your test data
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
{ " role " : " user " , " content " : " hi " } ,
] ,
" max_tokens " : 10 ,
}
print ( " testing proxy server with chat completions " )
response = client_no_auth . post (
" /v1/chat/completions " ,
json = test_data ,
headers = { " Authorization " : " Bearer {} " . format ( mock_api_key ) } ,
)
assert response . status_code == 429
# confirm async_log_failure_event is called
mock_failed_alert . assert_called ( )
assert len ( mock_logger_unit_tests . errors ) == 0
2024-05-04 08:56:39 +08:00
@mock_patch_acompletion ( )
def test_engines_model_chat_completions ( mock_acompletion , client_no_auth ) :
global headers
try :
# Your test data
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
{ " role " : " user " , " content " : " hi " } ,
] ,
" max_tokens " : 10 ,
}
print ( " testing proxy server with chat completions " )
2024-06-02 18:49:34 +08:00
response = client_no_auth . post (
" /engines/gpt-3.5-turbo/chat/completions " , json = test_data
)
2024-05-04 08:56:39 +08:00
mock_acompletion . assert_called_once_with (
model = " gpt-3.5-turbo " ,
messages = [
{ " role " : " user " , " content " : " hi " } ,
] ,
max_tokens = 10 ,
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
specific_deployment = True ,
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-04 08:56:39 +08:00
)
print ( f " response - { response . text } " )
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-11-24 12:56:40 +08:00
2023-12-12 12:03:01 +08:00
2024-05-03 04:36:23 +08:00
@mock_patch_acompletion ( )
def test_chat_completion_azure ( mock_acompletion , client_no_auth ) :
2023-12-07 10:38:44 +08:00
global headers
2023-11-24 12:56:40 +08:00
try :
# Your test data
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2023-11-24 12:56:40 +08:00
" messages " : [
2023-12-25 16:40:38 +08:00
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
2023-11-24 12:56:40 +08:00
] ,
" max_tokens " : 10 ,
}
2023-12-25 16:40:38 +08:00
2023-12-12 14:11:11 +08:00
print ( " testing proxy server with Azure Request /chat/completions " )
2023-12-12 13:30:02 +08:00
response = client_no_auth . post ( " /v1/chat/completions " , json = test_data )
2023-11-24 12:56:40 +08:00
2024-05-03 04:36:23 +08:00
mock_acompletion . assert_called_once_with (
2025-10-26 01:19:24 +08:00
model = " azure/gpt-4.1-mini " ,
2024-05-03 04:36:23 +08:00
messages = [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
max_tokens = 10 ,
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
specific_deployment = True ,
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-11-24 12:56:40 +08:00
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
2023-12-25 16:40:38 +08:00
assert len ( result [ " choices " ] [ 0 ] [ " message " ] [ " content " ] ) > 0
2023-11-24 12:56:40 +08:00
except Exception as e :
2023-12-06 03:13:09 +08:00
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-11-24 12:56:40 +08:00
2023-12-25 16:40:38 +08:00
2023-11-24 12:56:40 +08:00
# Run the test
2023-11-24 13:16:50 +08:00
# test_chat_completion_azure()
2023-11-24 12:56:40 +08:00
2023-12-25 16:40:38 +08:00
2024-05-03 03:24:49 +08:00
@mock_patch_acompletion ( )
2024-06-02 18:49:34 +08:00
def test_openai_deployments_model_chat_completions_azure (
mock_acompletion , client_no_auth
) :
2024-05-03 01:27:32 +08:00
global headers
try :
# Your test data
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-05-03 01:27:32 +08:00
" messages " : [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
" max_tokens " : 10 ,
}
2025-10-26 01:19:24 +08:00
url = " /openai/deployments/azure/gpt-4.1-mini/chat/completions "
2024-05-03 01:27:32 +08:00
print ( f " testing proxy server with Azure Request { url } " )
response = client_no_auth . post ( url , json = test_data )
2024-05-03 04:36:23 +08:00
mock_acompletion . assert_called_once_with (
2025-10-26 01:19:24 +08:00
model = " azure/gpt-4.1-mini " ,
2024-05-03 04:36:23 +08:00
messages = [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
max_tokens = 10 ,
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
specific_deployment = True ,
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2024-05-03 01:27:32 +08:00
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
assert len ( result [ " choices " ] [ 0 ] [ " message " ] [ " content " ] ) > 0
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
# Run the test
# test_openai_deployments_model_chat_completions_azure()
2023-12-25 16:40:38 +08:00
### EMBEDDING
2024-05-03 04:36:23 +08:00
@mock_patch_aembedding ( )
def test_embedding ( mock_aembedding , client_no_auth ) :
2023-12-07 10:38:44 +08:00
global headers
2023-12-25 16:40:38 +08:00
from litellm . proxy . proxy_server import user_custom_auth
2023-12-12 14:11:11 +08:00
2023-11-24 13:16:50 +08:00
try :
test_data = {
2025-09-28 03:41:35 +08:00
" model " : " azure/text-embedding-ada-002 " ,
2023-11-24 13:16:50 +08:00
" input " : [ " good morning from litellm " ] ,
}
2023-12-15 06:17:33 +08:00
[Perf] Embeddings: Use router's O(1) lookup and shared sessions (#16344)
* Refactor proxy embeddings to use shared processor
- allow ProxyBaseLLMRequestProcessing to accept the aembedding route so embeddings requests reuse the base pipeline hooks
- route embeddings requests through base_process_llm_request, sharing logging, hook execution, retries, and header handling with chat/responses
- tighten token array decoding logic by using router deployment lookups and the unified error handler
* Fix: Correctly process embedding requests with token arrays
The `test_embedding_input_array_of_tokens` test was failing due to a regression that caused embedding requests with token arrays to be processed incorrectly. This prevented the `aembedding` function from being called as expected.
This was caused by a combination of three distinct issues:
1. In `litellm/proxy/common_request_processing.py`, the `function_setup` utility was called with `aembedding` as the `original_function` for embedding routes. This has been corrected to `embedding` to ensure proper request setup.
2. In `litellm/proxy/proxy_server.py`, a `TypeError` occurred because the `get_deployment` method was called with the `model_name` keyword argument instead of the expected `model_id`. This has been corrected. Additionally, the check for token arrays was improved to validate that all elements in the input subarray are integers.
3. In `litellm/proxy/litellm_pre_call_utils.py`, the check for the `enforced_params` enterprise feature was too strict. It blocked valid requests even when the `enforced_params` list was empty. The condition has been adjusted to trigger the check only for non-empty lists.
Finally, the `test_embedding_input_array_of_tokens` assertion was updated to be more robust. The previous `assert_called_once_with` was overly strict, causing failures when unrelated internal parameters were added to the function call. The test now first asserts that `aembedding` is called and then separately verifies the `model` and `input` arguments. This makes the test more resilient to future changes without sacrificing its ability to catch regressions.
* test: align proxy embedding assertions
Update the embedding proxy test to match the new request pipeline: keep the data the proxy builds, expect the extra control kwargs, let the post-call hook return the actual response, and assert the normalized 'embeddings' hook type. This proves the refactor still forwards metadata and returns the mocked payload.
* Update proxy exception test
The proxy now forwards additional kwargs (request_timeout, litellm_call_id, litellm_logging_obj) to llm_router.aembedding. The test needs to accept these to match the real call signature and keep validating the error path instead of the kwargs list.
* testing: unsure of this change
I don't remember why I changed this, will revert and see if any tests fail since the manual test isn't failing without it.
* fix: remove unrelated change
This change was not related to the embeddings refactor and actually belonged to a different branch.
2025-11-15 01:21:45 +08:00
async def _pre_call_hook_side_effect ( * * kwargs ) :
data = kwargs [ " data " ]
metadata = { * * ( data . get ( " metadata " ) or { } ) , " source " : " unit-test " }
data [ " metadata " ] = metadata
proxy_request = { * * ( data . get ( " proxy_server_request " ) or { } ) }
proxy_request [ " path " ] = " /v1/embeddings "
data [ " proxy_server_request " ] = proxy_request
return data
async def _post_call_success_side_effect ( * * kwargs ) :
return kwargs [ " response " ]
2025-11-07 11:25:00 +08:00
2026-04-18 04:02:59 +08:00
with (
patch . object (
litellm . proxy . proxy_server . proxy_logging_obj ,
" pre_call_hook " ,
new = AsyncMock ( side_effect = _pre_call_hook_side_effect ) ,
) as mock_pre_call_hook ,
patch . object (
litellm . proxy . proxy_server . proxy_logging_obj ,
" during_call_hook " ,
new = AsyncMock ( return_value = None ) ,
) as mock_during_hook ,
patch . object (
litellm . proxy . proxy_server . proxy_logging_obj ,
" post_call_success_hook " ,
new = AsyncMock ( side_effect = _post_call_success_side_effect ) ,
) ,
2025-11-07 11:25:00 +08:00
) :
response = client_no_auth . post ( " /v1/embeddings " , json = test_data )
2023-12-15 06:17:33 +08:00
2024-05-03 04:36:23 +08:00
mock_aembedding . assert_called_once_with (
2025-09-28 03:41:35 +08:00
model = " azure/text-embedding-ada-002 " ,
2024-05-03 04:36:23 +08:00
input = [ " good morning from litellm " ] ,
specific_deployment = True ,
[Perf] Embeddings: Use router's O(1) lookup and shared sessions (#16344)
* Refactor proxy embeddings to use shared processor
- allow ProxyBaseLLMRequestProcessing to accept the aembedding route so embeddings requests reuse the base pipeline hooks
- route embeddings requests through base_process_llm_request, sharing logging, hook execution, retries, and header handling with chat/responses
- tighten token array decoding logic by using router deployment lookups and the unified error handler
* Fix: Correctly process embedding requests with token arrays
The `test_embedding_input_array_of_tokens` test was failing due to a regression that caused embedding requests with token arrays to be processed incorrectly. This prevented the `aembedding` function from being called as expected.
This was caused by a combination of three distinct issues:
1. In `litellm/proxy/common_request_processing.py`, the `function_setup` utility was called with `aembedding` as the `original_function` for embedding routes. This has been corrected to `embedding` to ensure proper request setup.
2. In `litellm/proxy/proxy_server.py`, a `TypeError` occurred because the `get_deployment` method was called with the `model_name` keyword argument instead of the expected `model_id`. This has been corrected. Additionally, the check for token arrays was improved to validate that all elements in the input subarray are integers.
3. In `litellm/proxy/litellm_pre_call_utils.py`, the check for the `enforced_params` enterprise feature was too strict. It blocked valid requests even when the `enforced_params` list was empty. The condition has been adjusted to trigger the check only for non-empty lists.
Finally, the `test_embedding_input_array_of_tokens` assertion was updated to be more robust. The previous `assert_called_once_with` was overly strict, causing failures when unrelated internal parameters were added to the function call. The test now first asserts that `aembedding` is called and then separately verifies the `model` and `input` arguments. This makes the test more resilient to future changes without sacrificing its ability to catch regressions.
* test: align proxy embedding assertions
Update the embedding proxy test to match the new request pipeline: keep the data the proxy builds, expect the extra control kwargs, let the post-call hook return the actual response, and assert the normalized 'embeddings' hook type. This proves the refactor still forwards metadata and returns the mocked payload.
* Update proxy exception test
The proxy now forwards additional kwargs (request_timeout, litellm_call_id, litellm_logging_obj) to llm_router.aembedding. The test needs to accept these to match the real call signature and keep validating the error path instead of the kwargs list.
* testing: unsure of this change
I don't remember why I changed this, will revert and see if any tests fail since the manual test isn't failing without it.
* fix: remove unrelated change
This change was not related to the embeddings refactor and actually belonged to a different branch.
2025-11-15 01:21:45 +08:00
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
2024-05-03 04:36:23 +08:00
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-12-15 06:17:33 +08:00
assert response . status_code == 200
result = response . json ( )
print ( len ( result [ " data " ] [ 0 ] [ " embedding " ] ) )
2023-12-25 16:40:38 +08:00
assert len ( result [ " data " ] [ 0 ] [ " embedding " ] ) > 10 # this usually has len==1536 so
2025-11-07 11:25:00 +08:00
[Perf] Embeddings: Use router's O(1) lookup and shared sessions (#16344)
* Refactor proxy embeddings to use shared processor
- allow ProxyBaseLLMRequestProcessing to accept the aembedding route so embeddings requests reuse the base pipeline hooks
- route embeddings requests through base_process_llm_request, sharing logging, hook execution, retries, and header handling with chat/responses
- tighten token array decoding logic by using router deployment lookups and the unified error handler
* Fix: Correctly process embedding requests with token arrays
The `test_embedding_input_array_of_tokens` test was failing due to a regression that caused embedding requests with token arrays to be processed incorrectly. This prevented the `aembedding` function from being called as expected.
This was caused by a combination of three distinct issues:
1. In `litellm/proxy/common_request_processing.py`, the `function_setup` utility was called with `aembedding` as the `original_function` for embedding routes. This has been corrected to `embedding` to ensure proper request setup.
2. In `litellm/proxy/proxy_server.py`, a `TypeError` occurred because the `get_deployment` method was called with the `model_name` keyword argument instead of the expected `model_id`. This has been corrected. Additionally, the check for token arrays was improved to validate that all elements in the input subarray are integers.
3. In `litellm/proxy/litellm_pre_call_utils.py`, the check for the `enforced_params` enterprise feature was too strict. It blocked valid requests even when the `enforced_params` list was empty. The condition has been adjusted to trigger the check only for non-empty lists.
Finally, the `test_embedding_input_array_of_tokens` assertion was updated to be more robust. The previous `assert_called_once_with` was overly strict, causing failures when unrelated internal parameters were added to the function call. The test now first asserts that `aembedding` is called and then separately verifies the `model` and `input` arguments. This makes the test more resilient to future changes without sacrificing its ability to catch regressions.
* test: align proxy embedding assertions
Update the embedding proxy test to match the new request pipeline: keep the data the proxy builds, expect the extra control kwargs, let the post-call hook return the actual response, and assert the normalized 'embeddings' hook type. This proves the refactor still forwards metadata and returns the mocked payload.
* Update proxy exception test
The proxy now forwards additional kwargs (request_timeout, litellm_call_id, litellm_logging_obj) to llm_router.aembedding. The test needs to accept these to match the real call signature and keep validating the error path instead of the kwargs list.
* testing: unsure of this change
I don't remember why I changed this, will revert and see if any tests fail since the manual test isn't failing without it.
* fix: remove unrelated change
This change was not related to the embeddings refactor and actually belonged to a different branch.
2025-11-15 01:21:45 +08:00
call_metadata = mock_aembedding . call_args . kwargs [ " metadata " ]
assert call_metadata . get ( " source " ) == " unit-test "
2025-11-07 11:25:00 +08:00
pre_call_kwargs = mock_pre_call_hook . await_args_list [ 0 ] . kwargs
assert (
pre_call_kwargs . get ( " call_type " ) == " aembedding "
) , f " expected pre_call_hook to receive call_type= ' aembedding ' , got { pre_call_kwargs . get ( ' call_type ' ) } "
2023-12-15 06:17:33 +08:00
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-12-25 16:40:38 +08:00
2024-05-03 04:36:23 +08:00
@mock_patch_aembedding ( )
def test_bedrock_embedding ( mock_aembedding , client_no_auth ) :
2023-12-15 06:17:33 +08:00
global headers
2023-12-25 16:40:38 +08:00
from litellm . proxy . proxy_server import user_custom_auth
2023-12-15 06:17:33 +08:00
try :
test_data = {
" model " : " amazon-embeddings " ,
" input " : [ " good morning from litellm " ] ,
}
2023-12-12 13:30:02 +08:00
response = client_no_auth . post ( " /v1/embeddings " , json = test_data )
2023-11-24 12:56:40 +08:00
2024-05-03 04:36:23 +08:00
mock_aembedding . assert_called_once_with (
model = " amazon-embeddings " ,
input = [ " good morning from litellm " ] ,
[Perf] Embeddings: Use router's O(1) lookup and shared sessions (#16344)
* Refactor proxy embeddings to use shared processor
- allow ProxyBaseLLMRequestProcessing to accept the aembedding route so embeddings requests reuse the base pipeline hooks
- route embeddings requests through base_process_llm_request, sharing logging, hook execution, retries, and header handling with chat/responses
- tighten token array decoding logic by using router deployment lookups and the unified error handler
* Fix: Correctly process embedding requests with token arrays
The `test_embedding_input_array_of_tokens` test was failing due to a regression that caused embedding requests with token arrays to be processed incorrectly. This prevented the `aembedding` function from being called as expected.
This was caused by a combination of three distinct issues:
1. In `litellm/proxy/common_request_processing.py`, the `function_setup` utility was called with `aembedding` as the `original_function` for embedding routes. This has been corrected to `embedding` to ensure proper request setup.
2. In `litellm/proxy/proxy_server.py`, a `TypeError` occurred because the `get_deployment` method was called with the `model_name` keyword argument instead of the expected `model_id`. This has been corrected. Additionally, the check for token arrays was improved to validate that all elements in the input subarray are integers.
3. In `litellm/proxy/litellm_pre_call_utils.py`, the check for the `enforced_params` enterprise feature was too strict. It blocked valid requests even when the `enforced_params` list was empty. The condition has been adjusted to trigger the check only for non-empty lists.
Finally, the `test_embedding_input_array_of_tokens` assertion was updated to be more robust. The previous `assert_called_once_with` was overly strict, causing failures when unrelated internal parameters were added to the function call. The test now first asserts that `aembedding` is called and then separately verifies the `model` and `input` arguments. This makes the test more resilient to future changes without sacrificing its ability to catch regressions.
* test: align proxy embedding assertions
Update the embedding proxy test to match the new request pipeline: keep the data the proxy builds, expect the extra control kwargs, let the post-call hook return the actual response, and assert the normalized 'embeddings' hook type. This proves the refactor still forwards metadata and returns the mocked payload.
* Update proxy exception test
The proxy now forwards additional kwargs (request_timeout, litellm_call_id, litellm_logging_obj) to llm_router.aembedding. The test needs to accept these to match the real call signature and keep validating the error path instead of the kwargs list.
* testing: unsure of this change
I don't remember why I changed this, will revert and see if any tests fail since the manual test isn't failing without it.
* fix: remove unrelated change
This change was not related to the embeddings refactor and actually belonged to a different branch.
2025-11-15 01:21:45 +08:00
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
2024-05-03 04:36:23 +08:00
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-11-24 13:16:50 +08:00
assert response . status_code == 200
[Perf] Embeddings: Use router's O(1) lookup and shared sessions (#16344)
* Refactor proxy embeddings to use shared processor
- allow ProxyBaseLLMRequestProcessing to accept the aembedding route so embeddings requests reuse the base pipeline hooks
- route embeddings requests through base_process_llm_request, sharing logging, hook execution, retries, and header handling with chat/responses
- tighten token array decoding logic by using router deployment lookups and the unified error handler
* Fix: Correctly process embedding requests with token arrays
The `test_embedding_input_array_of_tokens` test was failing due to a regression that caused embedding requests with token arrays to be processed incorrectly. This prevented the `aembedding` function from being called as expected.
This was caused by a combination of three distinct issues:
1. In `litellm/proxy/common_request_processing.py`, the `function_setup` utility was called with `aembedding` as the `original_function` for embedding routes. This has been corrected to `embedding` to ensure proper request setup.
2. In `litellm/proxy/proxy_server.py`, a `TypeError` occurred because the `get_deployment` method was called with the `model_name` keyword argument instead of the expected `model_id`. This has been corrected. Additionally, the check for token arrays was improved to validate that all elements in the input subarray are integers.
3. In `litellm/proxy/litellm_pre_call_utils.py`, the check for the `enforced_params` enterprise feature was too strict. It blocked valid requests even when the `enforced_params` list was empty. The condition has been adjusted to trigger the check only for non-empty lists.
Finally, the `test_embedding_input_array_of_tokens` assertion was updated to be more robust. The previous `assert_called_once_with` was overly strict, causing failures when unrelated internal parameters were added to the function call. The test now first asserts that `aembedding` is called and then separately verifies the `model` and `input` arguments. This makes the test more resilient to future changes without sacrificing its ability to catch regressions.
* test: align proxy embedding assertions
Update the embedding proxy test to match the new request pipeline: keep the data the proxy builds, expect the extra control kwargs, let the post-call hook return the actual response, and assert the normalized 'embeddings' hook type. This proves the refactor still forwards metadata and returns the mocked payload.
* Update proxy exception test
The proxy now forwards additional kwargs (request_timeout, litellm_call_id, litellm_logging_obj) to llm_router.aembedding. The test needs to accept these to match the real call signature and keep validating the error path instead of the kwargs list.
* testing: unsure of this change
I don't remember why I changed this, will revert and see if any tests fail since the manual test isn't failing without it.
* fix: remove unrelated change
This change was not related to the embeddings refactor and actually belonged to a different branch.
2025-11-15 01:21:45 +08:00
print ( response . status_code , response . text )
2023-11-24 13:16:50 +08:00
result = response . json ( )
print ( len ( result [ " data " ] [ 0 ] [ " embedding " ] ) )
2023-12-25 16:40:38 +08:00
assert len ( result [ " data " ] [ 0 ] [ " embedding " ] ) > 10 # this usually has len==1536 so
2023-11-24 13:16:50 +08:00
except Exception as e :
2023-12-06 03:13:09 +08:00
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-11-24 12:56:40 +08:00
2023-12-25 16:40:38 +08:00
2024-02-29 11:16:11 +08:00
@pytest.mark.skip ( reason = " AWS Suspended Account " )
2023-12-15 06:38:27 +08:00
def test_sagemaker_embedding ( client_no_auth ) :
global headers
2023-12-25 16:40:38 +08:00
from litellm . proxy . proxy_server import user_custom_auth
2023-12-15 06:38:27 +08:00
try :
test_data = {
" model " : " GPT-J 6B - Sagemaker Text Embedding (Internal) " ,
" input " : [ " good morning from litellm " ] ,
}
response = client_no_auth . post ( " /v1/embeddings " , json = test_data )
assert response . status_code == 200
result = response . json ( )
print ( len ( result [ " data " ] [ 0 ] [ " embedding " ] ) )
2023-12-25 16:40:38 +08:00
assert len ( result [ " data " ] [ 0 ] [ " embedding " ] ) > 10 # this usually has len==1536 so
2023-12-15 06:38:27 +08:00
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-12-25 16:40:38 +08:00
2023-11-24 13:16:50 +08:00
# Run the test
2023-11-24 12:56:40 +08:00
# test_embedding()
2023-12-21 18:09:09 +08:00
#### IMAGE GENERATION
2023-12-25 16:40:38 +08:00
2024-05-03 04:36:23 +08:00
@mock_patch_aimage_generation ( )
def test_img_gen ( mock_aimage_generation , client_no_auth ) :
2023-12-21 18:09:09 +08:00
global headers
2023-12-25 16:40:38 +08:00
from litellm . proxy . proxy_server import user_custom_auth
2023-12-21 18:09:09 +08:00
try :
test_data = {
" model " : " dall-e-3 " ,
" prompt " : " A cute baby sea otter " ,
" n " : 1 ,
2023-12-25 16:40:38 +08:00
" size " : " 1024x1024 " ,
Litellm oss staging 030626 (#29578)
* Fix incorrect agent API request example payload structure (#29556)
* fix(otel): add litellm_metadata fallback in _get_span_context and _end_proxy_span_from_kwargs (#29427)
* fix(otel): add litellm_metadata fallback in _get_span_context and _end_proxy_span_from_kwargs
On /v1/messages and other LITELLM_METADATA_ROUTES, the parent OTel span
is stored in litellm_params['litellm_metadata'] instead of
litellm_params['metadata']. When the request body contains a native
'metadata' field (e.g. Anthropic's {"user_id": "..."}),
litellm_params['metadata'] gets overwritten and the parent span is lost,
producing orphan root spans with a different trace_id.
Add fallback checks to litellm_metadata in:
- _get_span_context(): so child spans find the correct parent
- _end_proxy_span_from_kwargs(): so the proxy span gets closed
Fixes: https://github.com/BerriAI/litellm/issues/27934
* test(otel): tighten assertions per Greptile review
- test_span_context_metadata_takes_priority: assert litellm_metadata
span is never accessed, proving metadata takes priority
- test_span_context_no_parent_when_neither_has_span: assert both ctx
and detected_span are None
---------
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Aneesh-Fiddler <aneeshfiddler@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* fix: remove premature end-user budget check from get_end_user_object (#29420)
* fix(proxy): remove premature end-user budget check from get_end_user_object
Problem:
- `_check_end_user_budget()` was called inside `get_end_user_object()`
- This caused budget checks to run BEFORE `skip_budget_checks` could be evaluated
- Zero-cost models (e.g., local vLLM) were incorrectly blocked when
end-users exceeded their budget, even though they should bypass budget checks
Solution:
- Remove `_check_end_user_budget()` calls from `get_end_user_object()`
- Budget enforcement now happens exclusively in `common_checks()` where
`skip_budget_checks` context is available
- `get_end_user_object()` keeps `route` as optional in function parameter for backwards compatibility and future implementation.
* refactor(tests): update budget enforcement tests to reflect changes in get_end_user_object
- test_get_end_user_object() verifies data fetching
- test_check_end_user_budget() verifies enforcement
- test_budget_enforcement_blocks_over_budget_users() integrates _check_end_user_budget()
- test_resolve_end_user_reraises_budget_exceeded() is now test_resolve_end_user since no budget exceeded is thrown in get_end_user_object()
* Gemini /images/generate and /images/edits billing fixes + add support for size and aspect ratio params (#29534)
* Fix Gemini image config mapping
* Address Gemini image config review
* Format Gemini image generation transform
* Fix Gemini image token usage logging
* Share Gemini image request helpers
* Fix Gemini Imagen model routing
* Fixes as per self code review
* Fixes per internal code review
* Stop gating Imagen imageSize forwarding
* Document Gemini image size mapping source
* chore: retrigger lint
* Clarify Gemini candidate count precedence
* Add Inception provider (#29522)
* add inception as provider (chat, fim)
* linting
* seperate test suite for chat and fim
* fix test coverage
* fix: model hub custom pricing model info (#29293)
* Opik user auth key metadata extractors (#28397)
* fix: enhance Opik metadata extraction to include user API key auth context fixed after refactoring to extractor logic
* test: add unit tests for OPik metadata extraction logic
* fix: enhance extract_opik_metadata function to prioritize metadata sources for improved accuracy
* fix(ci): clarified comments and edited unit tests
* test: add unit tests for OPik metadata extraction with auth and requester overrides
* fix(ui): replace fixed favicon.ico with current api get /get_favicon (#29532)
Signed-off-by: José Luis Di Biase <josx@interorganic.com.ar>
* fix(vertex/gemini): keep tool_call reference when a text-only assistant message follows (#29561)
`_gemini_convert_messages_with_history` tracks `last_message_with_tool_calls`
so a following tool result can be matched back to its tool call. The assignment
was inside a branch guarded by
`assistant_msg.get("tool_calls", []) is not None`, which is also True for a
text-only assistant message (an empty list is not None). As a result, an
assistant message with no tool calls that appears between a tool call and its
tool result overwrote the reference, and conversion failed with:
Exception: Missing corresponding tool call for tool response message.
This shape is common: a model emits a short narration/assistant message after a
tool call before the tool result is appended.
Only update `last_message_with_tool_calls` when the assistant message actually
carries tool_calls (or a function_call). Adds a regression test.
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* Add 1-hour cache write pricing for EU/AU/JP Bedrock Anthropic models (#28572)
* fix(thinking): handle None thinking param in is_thinking_enabled (#28598)
Squash-merged by litellm-agent from Terrajlz's PR.
* feat(helm): support tpl rendering in podAnnotations (#28609)
Squash-merged by litellm-agent from devauxbr's PR.
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505) (#28575)
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505)
When a Chat Completions request to a GPT-5.4+ model contains both
`tools` and `reasoning_effort`, `completion()` auto-routes through
`responses_api_bridge`. The bridge handler called
`litellm.responses()` / `litellm.aresponses()` without forwarding the
already-resolved `custom_llm_provider`, so the downstream call
re-invoked `get_llm_provider()` with `custom_llm_provider=None` and
stripped a second provider prefix from a `provider/provider/model`
deployment string.
For a deployment configured as `openai/openai/openai/gpt-5.5`,
the bridge flow sent `openai/gpt-5.5` to the upstream API instead of
the correct `openai/openai/gpt-5.5`. Upstream APIs that enforce
model-name allow-lists rejected this as `key_model_access_denied`.
Fix: pass the locally-resolved `custom_llm_provider` into both the
sync `responses()` and async `aresponses()` calls so the downstream
`_resolve_model_provider_for_responses` sees an explicit provider
and skips the second prefix-strip.
New regression test
`tests/test_litellm/completion_extras/test_responses_bridge_provider_propagation.py`
pins both call sites: each must forward `custom_llm_provider`.
* fix(28505): set custom_llm_provider on request_data instead of as duplicate kwarg
Greptile flagged that the previous patch passed custom_llm_provider as an
explicit kwarg to responses()/aresponses() while request_data already
carried it via the spread of sanitized_litellm_params, which would raise
TypeError: got multiple values for keyword argument on every real bridge
call.
Switches to assigning request_data['custom_llm_provider'] before the call
so the resolved provider wins over whatever sanitized_litellm_params spread
in, without duplicating the kwarg.
Updates the regression test to seed request_data with a sentinel
custom_llm_provider so it actually exercises the overwrite path (the
previous test mocked transform_request with a minimal dict and never hit
the conflict).
* chore: trigger shin-agent re-eval on retargeted staging base
* chore: trigger shin-agent re-eval against updated Greptile state
* Add 1-hour cache write pricing for EU/AU/JP Bedrock Anthropic models
The 1-hour prompt-cache write tier
(`cache_creation_input_token_cost_above_1hr`) was added to the
us./global. variants of the Claude 4.5/4.6/4.7 family on Bedrock, but
the eu./au./jp. cross-region inference profiles were left without it.
AWS Bedrock pricing applies the same +10% regional premium across all
geo profiles, so eu./au./jp. should carry the same 1-hour rates as
us. (1.6x the 5-minute regional rate).
Without these fields, cost tracking on EU/AU/JP Bedrock 1-hour-TTL
prompt caching falls back to the 5-minute write rate and undercounts
spend by ~60% for European, Australian, and Japanese tenants.
Adds the 1-hour tier (and Sonnet 4.5's long-context >200K tier where
AWS publishes one) to 14 regional Bedrock entries in both
`model_prices_and_context_window.json` and the bundled
`model_prices_and_context_window_backup.json`:
- eu./au. Opus 4.6 ($11.00 / MTok)
- eu./au. Opus 4.7 ($11.00 / MTok)
- eu./au./jp. Sonnet 4.6 ($6.60 / MTok)
- eu./au./jp. Sonnet 4.5 ($6.60 / MTok regular, $13.20 / MTok LC)
- eu./au./jp. Haiku 4.5 ($2.20 / MTok)
Also extends `tests/test_litellm/test_bedrock_anthropic_1hr_cache_pricing.py`
with a `REGIONAL_EXPECTED` parametrized block covering all 13 new
entries plus the existing 1.6x ratio invariant.
Note: `eu.anthropic.claude-opus-4-5-20251101-v1:0` carries the
wrong 5m rate today (base 6.25e-06 instead of regional 6.875e-06),
which would break the 1.6x ratio check. It is intentionally left out
of this PR so the scope stays "1-hour cache tier addition" — a
separate follow-up should correct the EU 5m rates for Opus 4.5.
---------
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* Add 1-hour cache write pricing tier for Vertex AI Anthropic models (#28569)
* fix(thinking): handle None thinking param in is_thinking_enabled (#28598)
Squash-merged by litellm-agent from Terrajlz's PR.
* feat(helm): support tpl rendering in podAnnotations (#28609)
Squash-merged by litellm-agent from devauxbr's PR.
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505) (#28575)
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505)
When a Chat Completions request to a GPT-5.4+ model contains both
`tools` and `reasoning_effort`, `completion()` auto-routes through
`responses_api_bridge`. The bridge handler called
`litellm.responses()` / `litellm.aresponses()` without forwarding the
already-resolved `custom_llm_provider`, so the downstream call
re-invoked `get_llm_provider()` with `custom_llm_provider=None` and
stripped a second provider prefix from a `provider/provider/model`
deployment string.
For a deployment configured as `openai/openai/openai/gpt-5.5`,
the bridge flow sent `openai/gpt-5.5` to the upstream API instead of
the correct `openai/openai/gpt-5.5`. Upstream APIs that enforce
model-name allow-lists rejected this as `key_model_access_denied`.
Fix: pass the locally-resolved `custom_llm_provider` into both the
sync `responses()` and async `aresponses()` calls so the downstream
`_resolve_model_provider_for_responses` sees an explicit provider
and skips the second prefix-strip.
New regression test
`tests/test_litellm/completion_extras/test_responses_bridge_provider_propagation.py`
pins both call sites: each must forward `custom_llm_provider`.
* fix(28505): set custom_llm_provider on request_data instead of as duplicate kwarg
Greptile flagged that the previous patch passed custom_llm_provider as an
explicit kwarg to responses()/aresponses() while request_data already
carried it via the spread of sanitized_litellm_params, which would raise
TypeError: got multiple values for keyword argument on every real bridge
call.
Switches to assigning request_data['custom_llm_provider'] before the call
so the resolved provider wins over whatever sanitized_litellm_params spread
in, without duplicating the kwarg.
Updates the regression test to seed request_data with a sentinel
custom_llm_provider so it actually exercises the overwrite path (the
previous test mocked transform_request with a minimal dict and never hit
the conflict).
* chore: trigger shin-agent re-eval on retargeted staging base
* chore: trigger shin-agent re-eval against updated Greptile state
* Add 1-hour cache write pricing tier for Vertex AI Anthropic models
GCP Vertex AI publishes a separate 1-hour cache write column for the
Claude family (1.6x the 5-minute write rate, matching the documented
Bedrock ratio). LiteLLM's Vertex AI Anthropic entries only carry the
5-minute tier, so any request that uses `cache_control: {"ttl": "1h"}`
on Vertex AI Claude is undercounted in cost tracking by ~60%.
The runtime side already supports the 1-hour tier — `VertexAIAnthropicConfig`
extends `AnthropicConfig`, populating `ephemeral_1h_input_tokens`, and
`_calculate_cache_creation_cost` reads `cache_creation_input_token_cost_above_1hr`.
Only the price registry was missing data.
Adds the field to 19 vertex_ai/claude-* entries across both
`model_prices_and_context_window.json` and the bundled
`model_prices_and_context_window_backup.json`:
- Haiku 4.5 ($1.25 -> $2.00 / MTok)
- Sonnet 3.7 / 4 / 4.5 / 4.6 ($3.75 -> $6.00 / MTok)
- Opus 4.5 / 4.6 / 4.7 ($6.25 -> $10.00 / MTok)
- Opus 4 / 4.1 ($18.75 -> $30.00 / MTok)
Adds `tests/test_litellm/test_vertex_anthropic_1hr_cache_pricing.py`
mirroring the Bedrock equivalent — pins each (5m, 1h) pair per model
and asserts the 1.6x ratio across the family.
Fixes #27781.
---------
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* Fix Gemini multimodal function responses (#29325)
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
* address greptile review: add _transform_image_usage method and model-map supports_image_size flag
- Add _transform_image_usage instance method to GoogleImageGenConfig that
delegates to transform_gemini_image_usage, fixing the regression test
- Replace hardcoded "2.5-flash" string check in supports_gemini_image_size
with a get_model_info lookup on supports_image_size (default true)
- Add supports_image_size: false to all gemini-2.5-flash model entries in
model_prices_and_context_window.json so capability is controlled via the
model map rather than embedded in code
* fix test failures: schema validation, mypy type, model info plumbing, pricing test
- Add supports_image_size to ModelInfoBase TypedDict so get_model_info surfaces it
- Pass supports_image_size through _get_model_info_helper constructor call
- Fix supports_gemini_image_size to use value is not False (None means unset, defaults to True)
- Add supports_image_size to JSON schema in test_aaamodel_prices_and_context_window_json_is_valid
- Correct gemini-3.1-flash-lite pricing assertions in test to match JSON values
* Add Azure AI Kimi K2.6 metadata (#27052)
* Add Azure AI Kimi K2.6 metadata
* Scope Kimi metadata test cost map setup
* fall back to substring check for models not in model_prices_and_context_window.json
Models like gemini-2.5-flash-image-preview are not in the pricing JSON,
so get_model_info raises. Fall back to "2.5-flash" not in model when the
JSON has no explicit supports_image_size entry for the model.
* fix(inception): don't forward global litellm.api_key to Inception FIM
Match the Inception chat config: resolve only an Inception-specific key
(param, litellm.inception_key, or INCEPTION_API_KEY) for the text-completion
FIM path. The global litellm.api_key (often an OpenAI key) was both leaking
to api.inceptionlabs.ai and taking precedence over the configured Inception
key when set.
* fix(auth): enforce end-user budget on custom-auth path that skips common_checks
get_end_user_object() no longer raises BudgetExceededError, so custom-auth
deployments with custom_auth_run_common_checks unset (which skip the
centralized common_checks gate) stopped enforcing the end-user budget,
letting an over-budget end user keep making requests. Re-enforce the
budget in _run_post_custom_auth_checks on that path.
---------
Signed-off-by: José Luis Di Biase <josx@interorganic.com.ar>
Co-authored-by: Isha <72744901+IshaMeera@users.noreply.github.com>
Co-authored-by: aneeshsangvikar <aneeshsangvikar@fiddler.ai>
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Aneesh-Fiddler <aneeshfiddler@gmail.com>
Co-authored-by: Suleiman Elkhoury <108065141+suleimanelkhoury@users.noreply.github.com>
Co-authored-by: Dmitriy Alergant <93501479+DmitriyAlergant@users.noreply.github.com>
Co-authored-by: Yanis Miraoui <yanis.miraoui19@imperial.ac.uk>
Co-authored-by: Lovro Seder <vrovro@gmail.com>
Co-authored-by: Thomas Mildner <12685945+Thomas-Mildner@users.noreply.github.com>
Co-authored-by: José Luis Di Biase <josx@interorganic.com.ar>
Co-authored-by: Lai Quang Huy <64073540+1qh@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Filippo Menghi <113345637+Cyberfilo@users.noreply.github.com>
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: ZHONG Ziwen <67355585+zzw-math@users.noreply.github.com>
Co-authored-by: Emerson Gomes <emerson.gomes@thalesgroup.com>
Co-authored-by: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
2026-06-04 02:01:51 +08:00
" imageConfig " : { " aspectRatio " : " 9:16 " , " imageSize " : " 1K " } ,
2023-12-21 18:09:09 +08:00
}
response = client_no_auth . post ( " /v1/images/generations " , json = test_data )
2024-05-03 04:36:23 +08:00
mock_aimage_generation . assert_called_once_with (
2024-06-02 18:49:34 +08:00
model = " dall-e-3 " ,
prompt = " A cute baby sea otter " ,
2024-05-03 04:36:23 +08:00
n = 1 ,
2024-06-02 18:49:34 +08:00
size = " 1024x1024 " ,
Litellm oss staging 030626 (#29578)
* Fix incorrect agent API request example payload structure (#29556)
* fix(otel): add litellm_metadata fallback in _get_span_context and _end_proxy_span_from_kwargs (#29427)
* fix(otel): add litellm_metadata fallback in _get_span_context and _end_proxy_span_from_kwargs
On /v1/messages and other LITELLM_METADATA_ROUTES, the parent OTel span
is stored in litellm_params['litellm_metadata'] instead of
litellm_params['metadata']. When the request body contains a native
'metadata' field (e.g. Anthropic's {"user_id": "..."}),
litellm_params['metadata'] gets overwritten and the parent span is lost,
producing orphan root spans with a different trace_id.
Add fallback checks to litellm_metadata in:
- _get_span_context(): so child spans find the correct parent
- _end_proxy_span_from_kwargs(): so the proxy span gets closed
Fixes: https://github.com/BerriAI/litellm/issues/27934
* test(otel): tighten assertions per Greptile review
- test_span_context_metadata_takes_priority: assert litellm_metadata
span is never accessed, proving metadata takes priority
- test_span_context_no_parent_when_neither_has_span: assert both ctx
and detected_span are None
---------
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Aneesh-Fiddler <aneeshfiddler@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* fix: remove premature end-user budget check from get_end_user_object (#29420)
* fix(proxy): remove premature end-user budget check from get_end_user_object
Problem:
- `_check_end_user_budget()` was called inside `get_end_user_object()`
- This caused budget checks to run BEFORE `skip_budget_checks` could be evaluated
- Zero-cost models (e.g., local vLLM) were incorrectly blocked when
end-users exceeded their budget, even though they should bypass budget checks
Solution:
- Remove `_check_end_user_budget()` calls from `get_end_user_object()`
- Budget enforcement now happens exclusively in `common_checks()` where
`skip_budget_checks` context is available
- `get_end_user_object()` keeps `route` as optional in function parameter for backwards compatibility and future implementation.
* refactor(tests): update budget enforcement tests to reflect changes in get_end_user_object
- test_get_end_user_object() verifies data fetching
- test_check_end_user_budget() verifies enforcement
- test_budget_enforcement_blocks_over_budget_users() integrates _check_end_user_budget()
- test_resolve_end_user_reraises_budget_exceeded() is now test_resolve_end_user since no budget exceeded is thrown in get_end_user_object()
* Gemini /images/generate and /images/edits billing fixes + add support for size and aspect ratio params (#29534)
* Fix Gemini image config mapping
* Address Gemini image config review
* Format Gemini image generation transform
* Fix Gemini image token usage logging
* Share Gemini image request helpers
* Fix Gemini Imagen model routing
* Fixes as per self code review
* Fixes per internal code review
* Stop gating Imagen imageSize forwarding
* Document Gemini image size mapping source
* chore: retrigger lint
* Clarify Gemini candidate count precedence
* Add Inception provider (#29522)
* add inception as provider (chat, fim)
* linting
* seperate test suite for chat and fim
* fix test coverage
* fix: model hub custom pricing model info (#29293)
* Opik user auth key metadata extractors (#28397)
* fix: enhance Opik metadata extraction to include user API key auth context fixed after refactoring to extractor logic
* test: add unit tests for OPik metadata extraction logic
* fix: enhance extract_opik_metadata function to prioritize metadata sources for improved accuracy
* fix(ci): clarified comments and edited unit tests
* test: add unit tests for OPik metadata extraction with auth and requester overrides
* fix(ui): replace fixed favicon.ico with current api get /get_favicon (#29532)
Signed-off-by: José Luis Di Biase <josx@interorganic.com.ar>
* fix(vertex/gemini): keep tool_call reference when a text-only assistant message follows (#29561)
`_gemini_convert_messages_with_history` tracks `last_message_with_tool_calls`
so a following tool result can be matched back to its tool call. The assignment
was inside a branch guarded by
`assistant_msg.get("tool_calls", []) is not None`, which is also True for a
text-only assistant message (an empty list is not None). As a result, an
assistant message with no tool calls that appears between a tool call and its
tool result overwrote the reference, and conversion failed with:
Exception: Missing corresponding tool call for tool response message.
This shape is common: a model emits a short narration/assistant message after a
tool call before the tool result is appended.
Only update `last_message_with_tool_calls` when the assistant message actually
carries tool_calls (or a function_call). Adds a regression test.
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* Add 1-hour cache write pricing for EU/AU/JP Bedrock Anthropic models (#28572)
* fix(thinking): handle None thinking param in is_thinking_enabled (#28598)
Squash-merged by litellm-agent from Terrajlz's PR.
* feat(helm): support tpl rendering in podAnnotations (#28609)
Squash-merged by litellm-agent from devauxbr's PR.
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505) (#28575)
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505)
When a Chat Completions request to a GPT-5.4+ model contains both
`tools` and `reasoning_effort`, `completion()` auto-routes through
`responses_api_bridge`. The bridge handler called
`litellm.responses()` / `litellm.aresponses()` without forwarding the
already-resolved `custom_llm_provider`, so the downstream call
re-invoked `get_llm_provider()` with `custom_llm_provider=None` and
stripped a second provider prefix from a `provider/provider/model`
deployment string.
For a deployment configured as `openai/openai/openai/gpt-5.5`,
the bridge flow sent `openai/gpt-5.5` to the upstream API instead of
the correct `openai/openai/gpt-5.5`. Upstream APIs that enforce
model-name allow-lists rejected this as `key_model_access_denied`.
Fix: pass the locally-resolved `custom_llm_provider` into both the
sync `responses()` and async `aresponses()` calls so the downstream
`_resolve_model_provider_for_responses` sees an explicit provider
and skips the second prefix-strip.
New regression test
`tests/test_litellm/completion_extras/test_responses_bridge_provider_propagation.py`
pins both call sites: each must forward `custom_llm_provider`.
* fix(28505): set custom_llm_provider on request_data instead of as duplicate kwarg
Greptile flagged that the previous patch passed custom_llm_provider as an
explicit kwarg to responses()/aresponses() while request_data already
carried it via the spread of sanitized_litellm_params, which would raise
TypeError: got multiple values for keyword argument on every real bridge
call.
Switches to assigning request_data['custom_llm_provider'] before the call
so the resolved provider wins over whatever sanitized_litellm_params spread
in, without duplicating the kwarg.
Updates the regression test to seed request_data with a sentinel
custom_llm_provider so it actually exercises the overwrite path (the
previous test mocked transform_request with a minimal dict and never hit
the conflict).
* chore: trigger shin-agent re-eval on retargeted staging base
* chore: trigger shin-agent re-eval against updated Greptile state
* Add 1-hour cache write pricing for EU/AU/JP Bedrock Anthropic models
The 1-hour prompt-cache write tier
(`cache_creation_input_token_cost_above_1hr`) was added to the
us./global. variants of the Claude 4.5/4.6/4.7 family on Bedrock, but
the eu./au./jp. cross-region inference profiles were left without it.
AWS Bedrock pricing applies the same +10% regional premium across all
geo profiles, so eu./au./jp. should carry the same 1-hour rates as
us. (1.6x the 5-minute regional rate).
Without these fields, cost tracking on EU/AU/JP Bedrock 1-hour-TTL
prompt caching falls back to the 5-minute write rate and undercounts
spend by ~60% for European, Australian, and Japanese tenants.
Adds the 1-hour tier (and Sonnet 4.5's long-context >200K tier where
AWS publishes one) to 14 regional Bedrock entries in both
`model_prices_and_context_window.json` and the bundled
`model_prices_and_context_window_backup.json`:
- eu./au. Opus 4.6 ($11.00 / MTok)
- eu./au. Opus 4.7 ($11.00 / MTok)
- eu./au./jp. Sonnet 4.6 ($6.60 / MTok)
- eu./au./jp. Sonnet 4.5 ($6.60 / MTok regular, $13.20 / MTok LC)
- eu./au./jp. Haiku 4.5 ($2.20 / MTok)
Also extends `tests/test_litellm/test_bedrock_anthropic_1hr_cache_pricing.py`
with a `REGIONAL_EXPECTED` parametrized block covering all 13 new
entries plus the existing 1.6x ratio invariant.
Note: `eu.anthropic.claude-opus-4-5-20251101-v1:0` carries the
wrong 5m rate today (base 6.25e-06 instead of regional 6.875e-06),
which would break the 1.6x ratio check. It is intentionally left out
of this PR so the scope stays "1-hour cache tier addition" — a
separate follow-up should correct the EU 5m rates for Opus 4.5.
---------
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* Add 1-hour cache write pricing tier for Vertex AI Anthropic models (#28569)
* fix(thinking): handle None thinking param in is_thinking_enabled (#28598)
Squash-merged by litellm-agent from Terrajlz's PR.
* feat(helm): support tpl rendering in podAnnotations (#28609)
Squash-merged by litellm-agent from devauxbr's PR.
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505) (#28575)
* Forward custom_llm_provider through the Responses API bridge (Fixes #28505)
When a Chat Completions request to a GPT-5.4+ model contains both
`tools` and `reasoning_effort`, `completion()` auto-routes through
`responses_api_bridge`. The bridge handler called
`litellm.responses()` / `litellm.aresponses()` without forwarding the
already-resolved `custom_llm_provider`, so the downstream call
re-invoked `get_llm_provider()` with `custom_llm_provider=None` and
stripped a second provider prefix from a `provider/provider/model`
deployment string.
For a deployment configured as `openai/openai/openai/gpt-5.5`,
the bridge flow sent `openai/gpt-5.5` to the upstream API instead of
the correct `openai/openai/gpt-5.5`. Upstream APIs that enforce
model-name allow-lists rejected this as `key_model_access_denied`.
Fix: pass the locally-resolved `custom_llm_provider` into both the
sync `responses()` and async `aresponses()` calls so the downstream
`_resolve_model_provider_for_responses` sees an explicit provider
and skips the second prefix-strip.
New regression test
`tests/test_litellm/completion_extras/test_responses_bridge_provider_propagation.py`
pins both call sites: each must forward `custom_llm_provider`.
* fix(28505): set custom_llm_provider on request_data instead of as duplicate kwarg
Greptile flagged that the previous patch passed custom_llm_provider as an
explicit kwarg to responses()/aresponses() while request_data already
carried it via the spread of sanitized_litellm_params, which would raise
TypeError: got multiple values for keyword argument on every real bridge
call.
Switches to assigning request_data['custom_llm_provider'] before the call
so the resolved provider wins over whatever sanitized_litellm_params spread
in, without duplicating the kwarg.
Updates the regression test to seed request_data with a sentinel
custom_llm_provider so it actually exercises the overwrite path (the
previous test mocked transform_request with a minimal dict and never hit
the conflict).
* chore: trigger shin-agent re-eval on retargeted staging base
* chore: trigger shin-agent re-eval against updated Greptile state
* Add 1-hour cache write pricing tier for Vertex AI Anthropic models
GCP Vertex AI publishes a separate 1-hour cache write column for the
Claude family (1.6x the 5-minute write rate, matching the documented
Bedrock ratio). LiteLLM's Vertex AI Anthropic entries only carry the
5-minute tier, so any request that uses `cache_control: {"ttl": "1h"}`
on Vertex AI Claude is undercounted in cost tracking by ~60%.
The runtime side already supports the 1-hour tier — `VertexAIAnthropicConfig`
extends `AnthropicConfig`, populating `ephemeral_1h_input_tokens`, and
`_calculate_cache_creation_cost` reads `cache_creation_input_token_cost_above_1hr`.
Only the price registry was missing data.
Adds the field to 19 vertex_ai/claude-* entries across both
`model_prices_and_context_window.json` and the bundled
`model_prices_and_context_window_backup.json`:
- Haiku 4.5 ($1.25 -> $2.00 / MTok)
- Sonnet 3.7 / 4 / 4.5 / 4.6 ($3.75 -> $6.00 / MTok)
- Opus 4.5 / 4.6 / 4.7 ($6.25 -> $10.00 / MTok)
- Opus 4 / 4.1 ($18.75 -> $30.00 / MTok)
Adds `tests/test_litellm/test_vertex_anthropic_1hr_cache_pricing.py`
mirroring the Bedrock equivalent — pins each (5m, 1h) pair per model
and asserts the 1.6x ratio across the family.
Fixes #27781.
---------
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: Sameer Kankute <sameer@berri.ai>
* Fix Gemini multimodal function responses (#29325)
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
* address greptile review: add _transform_image_usage method and model-map supports_image_size flag
- Add _transform_image_usage instance method to GoogleImageGenConfig that
delegates to transform_gemini_image_usage, fixing the regression test
- Replace hardcoded "2.5-flash" string check in supports_gemini_image_size
with a get_model_info lookup on supports_image_size (default true)
- Add supports_image_size: false to all gemini-2.5-flash model entries in
model_prices_and_context_window.json so capability is controlled via the
model map rather than embedded in code
* fix test failures: schema validation, mypy type, model info plumbing, pricing test
- Add supports_image_size to ModelInfoBase TypedDict so get_model_info surfaces it
- Pass supports_image_size through _get_model_info_helper constructor call
- Fix supports_gemini_image_size to use value is not False (None means unset, defaults to True)
- Add supports_image_size to JSON schema in test_aaamodel_prices_and_context_window_json_is_valid
- Correct gemini-3.1-flash-lite pricing assertions in test to match JSON values
* Add Azure AI Kimi K2.6 metadata (#27052)
* Add Azure AI Kimi K2.6 metadata
* Scope Kimi metadata test cost map setup
* fall back to substring check for models not in model_prices_and_context_window.json
Models like gemini-2.5-flash-image-preview are not in the pricing JSON,
so get_model_info raises. Fall back to "2.5-flash" not in model when the
JSON has no explicit supports_image_size entry for the model.
* fix(inception): don't forward global litellm.api_key to Inception FIM
Match the Inception chat config: resolve only an Inception-specific key
(param, litellm.inception_key, or INCEPTION_API_KEY) for the text-completion
FIM path. The global litellm.api_key (often an OpenAI key) was both leaking
to api.inceptionlabs.ai and taking precedence over the configured Inception
key when set.
* fix(auth): enforce end-user budget on custom-auth path that skips common_checks
get_end_user_object() no longer raises BudgetExceededError, so custom-auth
deployments with custom_auth_run_common_checks unset (which skip the
centralized common_checks gate) stopped enforcing the end-user budget,
letting an over-budget end user keep making requests. Re-enforce the
budget in _run_post_custom_auth_checks on that path.
---------
Signed-off-by: José Luis Di Biase <josx@interorganic.com.ar>
Co-authored-by: Isha <72744901+IshaMeera@users.noreply.github.com>
Co-authored-by: aneeshsangvikar <aneeshsangvikar@fiddler.ai>
Co-authored-by: shin-berri <shin-laptop@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
Co-authored-by: Aneesh-Fiddler <aneeshfiddler@gmail.com>
Co-authored-by: Suleiman Elkhoury <108065141+suleimanelkhoury@users.noreply.github.com>
Co-authored-by: Dmitriy Alergant <93501479+DmitriyAlergant@users.noreply.github.com>
Co-authored-by: Yanis Miraoui <yanis.miraoui19@imperial.ac.uk>
Co-authored-by: Lovro Seder <vrovro@gmail.com>
Co-authored-by: Thomas Mildner <12685945+Thomas-Mildner@users.noreply.github.com>
Co-authored-by: José Luis Di Biase <josx@interorganic.com.ar>
Co-authored-by: Lai Quang Huy <64073540+1qh@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Filippo Menghi <113345637+Cyberfilo@users.noreply.github.com>
Co-authored-by: Terrajlz <info@jouleselectrictech.com>
Co-authored-by: Bruno Devaux <devaux.br@gmail.com>
Co-authored-by: ZHONG Ziwen <67355585+zzw-math@users.noreply.github.com>
Co-authored-by: Emerson Gomes <emerson.gomes@thalesgroup.com>
Co-authored-by: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
2026-06-04 02:01:51 +08:00
imageConfig = { " aspectRatio " : " 9:16 " , " imageSize " : " 1K " } ,
2024-05-03 04:36:23 +08:00
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-12-21 18:09:09 +08:00
assert response . status_code == 200
result = response . json ( )
print ( len ( result [ " data " ] [ 0 ] [ " url " ] ) )
2023-12-25 16:40:38 +08:00
assert len ( result [ " data " ] [ 0 ] [ " url " ] ) > 10
2023-12-21 18:09:09 +08:00
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-12-03 06:15:38 +08:00
2023-12-25 16:40:38 +08:00
#### ADDITIONAL
2024-04-04 13:37:51 +08:00
@pytest.mark.skip ( reason = " test via docker tests. Requires prisma client. " )
2023-12-12 13:30:02 +08:00
def test_add_new_model ( client_no_auth ) :
2023-12-07 10:38:44 +08:00
global headers
2023-12-25 16:40:38 +08:00
try :
2023-12-03 06:15:38 +08:00
test_data = {
" model_name " : " test_openai_models " ,
" litellm_params " : {
2023-12-25 16:40:38 +08:00
" model " : " gpt-3.5-turbo " ,
2023-12-03 06:15:38 +08:00
} ,
2023-12-25 16:40:38 +08:00
" model_info " : { " description " : " this is a test openai model " } ,
2023-12-03 06:15:38 +08:00
}
2023-12-12 13:30:02 +08:00
client_no_auth . post ( " /model/new " , json = test_data , headers = headers )
response = client_no_auth . get ( " /model/info " , headers = headers )
2023-12-03 06:15:38 +08:00
assert response . status_code == 200
2023-12-25 16:40:38 +08:00
result = response . json ( )
2023-12-03 06:15:38 +08:00
print ( f " response: { result } " )
model_info = None
for m in result [ " data " ] :
2023-12-10 14:43:27 +08:00
if m [ " model_name " ] == " test_openai_models " :
model_info = m [ " model_info " ]
2023-12-03 06:15:38 +08:00
assert model_info [ " description " ] == " this is a test openai model "
2023-12-25 16:40:38 +08:00
except Exception as e :
2023-12-03 06:15:38 +08:00
pytest . fail ( f " LiteLLM Proxy test failed. Exception { str ( e ) } " )
2023-12-22 13:38:44 +08:00
[Release Fix] (#22411)
* fix(lint): suppress PLR0915 for 3 complex methods that exceed 50-statement limit
- streaming_iterator.py: _process_event (84 statements)
- transformation.py: translate_messages_to_responses_input (51 statements)
- transformation.py: transform_realtime_response (54 statements)
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(mypy): resolve type errors in public_endpoints, user_api_key_auth, common_utils, transformation
- public_endpoints.py: fix _cached_endpoints type annotation
- user_api_key_auth.py: accept Optional[str] for end_user_id parameter
- common_utils.py: add NewProjectRequest/UpdateProjectRequest to Union type
- transformation.py: add ChatCompletionRedactedThinkingBlock and list[Any] to content type
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(proxy-extras): bump version to 0.4.50 and sync schema
- Bump litellm-proxy-extras from 0.4.49 to 0.4.50
- Sync schema.prisma with main proxy schema
- Includes new LiteLLM_ClaudeCodePluginTable model
- Includes new @@index([startTime, request_id]) on SpendLogs
- Update version references in requirements.txt and pyproject.toml
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(router): use string id in test_add_deployment and add defensive str() in register_model
- Change test to use string '100' instead of int 100 for model_info.id
- Add str() conversion in register_model to prevent AttributeError on non-string keys
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(security): update minimatch to 10.2.4 to fix CVE-2026-27903 and CVE-2026-27904
- Run npm audit fix in docs/my-website
- Updates minimatch from 10.2.1 to 10.2.4 (fixes HIGH severity ReDoS vulnerabilities)
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): update realtime guardrail test assertions to match actual guardrail behavior
- test_text_message_blocked_by_guardrail_no_ai_response: allow guardrail's own block
message text in response.done (previously expected empty content)
- test_voice_transcript_blocked_by_guardrail: allow guardrail to send response.cancel
+ block message + response.create flow (previously expected no response.create)
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: revert proxy-extras version in requirements.txt and pyproject.toml
The litellm-proxy-extras 0.4.50 is not published to PyPI yet, so consumer
references must stay at 0.4.49. Only the source package pyproject.toml
should be bumped to 0.4.50 for the publish_proxy_extras CI job.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: make transcript delta check optional in voice guardrail test
The guardrail sends an error event (guardrail_violation) when blocking
voice transcripts; it does not always produce transcript deltas. Remove
the assertion requiring response.audio_transcript.delta since the error
event is the primary signal that blocked content was handled.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* Add missing env keys to documentation: LITELLM_MAX_STREAMING_DURATION_SECONDS and LITELLM_USE_CHAT_COMPLETIONS_URL_FOR_ANTHROPIC_MESSAGES
These two environment variables were used in code but not documented in the
environment variables reference section of config_settings.md, causing the
test_env_keys.py CI test to fail.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* Fix 13 mypy type errors across 6 files
- in_flight_requests_middleware.py: Fix type: ignore error codes from
[union-attr] to [attr-defined], add [arg-type] for Gauge **kwargs
- transformation.py: Add [assignment] ignore for output_format reassignment,
add fallback empty string for tool use id to fix arg-type
- responses/main.py: Remove redundant type annotation on second
secret_fields assignment to fix no-redef
- streaming_iterator.py: Add [assignment] ignores for intermediate
cache token assignments
- handler.py: Add [typeddict-item] ignore for AnthropicMessagesRequest
construction from dict
- public_endpoints.py: Add [arg-type] ignore for _load_endpoints()
return type mismatch with SupportedEndpoint model
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: add auth overrides to spend tracking tests, fix realtime guardrail assertion, update UI minimatch
- Add app.dependency_overrides for user_api_key_auth in 4 spend tracking tests
that were returning 401 Unauthorized (error_code, error_message,
error_code_and_key_alias, key_hash)
- Fix realtime guardrail test to check ANY error event for guardrail_violation
instead of just the first (OpenAI may send its own errors first)
- Update ui/litellm-dashboard/package-lock.json to fix minimatch vulnerability
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* Fix failing MCP e2e and create_mcp_server UI tests
Test 1 (test_independent_clients_no_shared_session):
- Add allow_all_keys: true to MCP servers in test config. With master_key
and no DB, get_allowed_mcp_servers returned empty, causing 0 tools and
403 on tool calls. allow_all_keys bypasses per-key restrictions.
- Add asyncio.sleep(0.5) between client connections to allow MCP SDK
TaskGroup cleanup and avoid ExceptionGroup on connection close (MCP #915).
Test 2 (create_mcp_server 'auth value is provided'):
- Use userEvent.setup({ delay: null }) for instant keystrokes to avoid
timeout from default typing delay on CI.
- Increase per-test timeout to 15000ms for CI environments.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: stabilize proxy unit tests for parallel execution
- test_response_polling_handler: add xdist_group to prevent heavy import OOM
- test_db_schema_migration: use temp dir for worker isolation, sync schema.prisma index
- test_custom_tokenizer_bug: use lighter tokenizer to prevent OOM in parallel
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: add auth overrides to more spend tracking and model info tests
- Fix test_ui_view_spend_logs_pagination missing auth override (401)
- Fix test_view_spend_tags missing auth override (401)
- Fix test_view_spend_tags_no_database missing auth override (401)
- Fix test_empty_model_list.py to use app.dependency_overrides instead of patch()
for FastAPI dependency injection auth
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): use patch.object for aiohttp transport test to work in parallel execution
The @patch decorator was not intercepting the static method call in parallel
xdist workers. Using patch.object on the directly-imported class is more reliable.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(security): update minimatch from 10.2.1 to 10.2.4 in Dockerfile
The Docker image was explicitly pinning minimatch@10.2.1 which has HIGH
severity ReDoS vulnerabilities (GHSA-7r86-cg39-jmmj, GHSA-23c5-xmqv-rm74).
Update to 10.2.4 which includes fixes for both CVEs.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(ui): prevent MCP and TeamInfo test timeouts on CI
- Add userEvent.setup({ delay: null }) to all tests using userEvent in both files
- Add timeout: 15000 to tests with significant user interaction (typing, multiple clicks)
- Fixes: create_mcp_server Bearer Token test, TeamInfo cancel button test
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix: stabilize parallel test execution and aiohttp transport test
- test_aiohttp_handler: rewrite transport test to not rely on static method mock
(consistently fails in parallel xdist workers)
- test_proxy_cli: add xdist_group to prevent timeout during heavy imports
- test_swagger_chat_completions: add xdist_group to prevent timeout
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(security): add serialize-javascript override to fix GHSA-5c6j-r48x-rmvq
Add npm override for serialize-javascript>=7.0.3 in docs/my-website
to fix HIGH severity RCE vulnerability via RegExp.flags.
Also bump minimatch override to >=10.2.4.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* Fix flaky tests: remove broken Vertex model, add retries for Anthropic
- Remove vertex_ai/meta/llama-4-scout-17b-16e-instruct-maas from
test_partner_models_httpx_streaming - consistently returns 400 BadRequest
- Add @pytest.mark.flaky(retries=6, delay=10) to test_function_call_parsing
for transient Anthropic API overload errors
- Add @pytest.mark.flaky(retries=6, delay=10) to test_openai_stream_options_call
for transient Anthropic InternalServerError
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(ci): add xdist_group(proxy_heavy) to prevent OOM in parallel proxy tests
- Add pytestmark = pytest.mark.xdist_group('proxy_heavy') to test_proxy_utils.py
- Change test_db_schema_migration.py from schema_migration to proxy_heavy group
- Add @pytest.mark.xdist_group('proxy_heavy') to test_proxy_server.py::test_health
Groups heavy proxy tests to run on same worker, avoiding worker OOM crashes.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* Fix vertex AI qwen global endpoint test to mock vertexai module import
The test_vertex_ai_qwen_global_endpoint_url test was failing because the
VertexAIPartnerModels.completion() method tries to 'import vertexai' before
any of the mocked code runs. In environments without google-cloud-aiplatform
installed, this import fails with a VertexAIError(status_code=400).
Fix by:
- Adding patch.dict('sys.modules', {'vertexai': MagicMock()}) to mock the
vertexai module import
- Adding vertex_ai_location parameter to the acompletion call for completeness
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(ci): add xdist_group to health endpoint and watsonx tests for parallel stability
- test_health_liveliness_endpoint: add xdist_group('proxy_health') to prevent timeout
- test_watsonx_gpt_oss tests: add xdist_group('watsonx_heavy') to prevent mock interference
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): pre-populate WatsonX IAM token cache to prevent parallel test interference
The watsonx prompt transformation test was failing in parallel execution because
litellm.module_level_client.post mock was being interfered with by other tests.
Pre-populating the IAM token cache avoids the HTTP call entirely.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): add spend data polling with retries for e2e pass-through tests
- test_vertex_with_spend.test.js: Replace 15s fixed wait with polling loop
(up to 6 attempts, 10s apart) for spend data to appear in DB
- Increase test timeout from 25s to 90s to accommodate polling
- base_anthropic_messages_tool_search_test.py: Add flaky(retries=3) for
streaming test that depends on live Anthropic API
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(ci): reduce parallel workers from 8 to 4 for proxy tests to prevent OOM
- litellm_proxy_unit_testing_part2: -n 8 -> -n 4
- litellm_mapped_tests_proxy_part2: -n 8 -> -n 4, timeout 60 -> 120
- Worker crashes consistently caused by too many parallel proxy tests
each loading the full FastAPI app and heavy dependency tree
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(db): add migration for SpendLogs composite index (startTime, request_id)
The @@index([startTime, request_id]) was added to schema.prisma but had no
corresponding migration. This caused test_aaaasschema_migration_check to fail
because prisma migrate diff detected the missing index.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(db): add migration for MCP available_on_public_internet default change to true
The schema.prisma changed the default for available_on_public_internet from
false to true, but no migration was created. This caused the schema migration
test to detect drift.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): increase server wait time and add retry to flaky external API tests
- test_basic_python_version.py: increase server startup wait from 60s to 90s
for slower CI environments (fixes installing_litellm_on_python_3_13)
- test_a2a_agent.py: add flaky(retries=3, delay=5) for non-streaming test
that depends on live A2A agent endpoint
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): add flaky retries to all intermittent external API tests for 0-fail CI
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
* fix(test): add auth overrides to file endpoint tests that return 500
The test_target_storage tests were getting 500 because the FastAPI auth
dependency wasn't overridden. Added app.dependency_overrides for proper
auth bypass in test environment.
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
2026-03-01 01:46:35 +08:00
@pytest.mark.xdist_group ( " proxy_heavy " )
2023-12-22 13:38:44 +08:00
def test_health ( client_no_auth ) :
global headers
2024-07-17 08:15:20 +08:00
import logging
2023-12-22 13:38:44 +08:00
import time
2024-07-17 08:15:20 +08:00
2024-06-16 06:09:49 +08:00
from litellm . _logging import verbose_logger , verbose_proxy_logger
verbose_proxy_logger . setLevel ( logging . DEBUG )
2023-12-25 16:40:38 +08:00
2023-12-22 13:38:44 +08:00
try :
response = client_no_auth . get ( " /health " )
assert response . status_code == 200
except Exception as e :
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
2023-12-25 16:40:38 +08:00
2023-12-05 02:19:35 +08:00
# test_add_new_model()
from litellm . integrations . custom_logger import CustomLogger
2023-12-25 16:40:38 +08:00
2023-12-05 02:19:35 +08:00
class MyCustomHandler ( CustomLogger ) :
2023-12-25 16:40:38 +08:00
def log_pre_api_call ( self , model , messages , kwargs ) :
2023-12-05 02:19:35 +08:00
print ( f " Pre-API Call " )
2023-12-25 16:40:38 +08:00
def log_success_event ( self , kwargs , response_obj , start_time , end_time ) :
2023-12-05 02:19:35 +08:00
print ( f " On Success " )
assert kwargs [ " user " ] == " proxy-user "
assert kwargs [ " model " ] == " gpt-3.5-turbo "
assert kwargs [ " max_tokens " ] == 10
2023-12-25 16:40:38 +08:00
2023-12-05 02:19:35 +08:00
customHandler = MyCustomHandler ( )
2024-05-03 04:36:23 +08:00
@mock_patch_acompletion ( )
def test_chat_completion_optional_params ( mock_acompletion , client_no_auth ) :
2023-12-05 02:19:35 +08:00
# [PROXY: PROD TEST] - DO NOT DELETE
# This tests if all the /chat/completion params are passed to litellm
try :
# Your test data
2023-12-25 16:40:38 +08:00
litellm . set_verbose = True
2023-12-05 02:19:35 +08:00
test_data = {
" model " : " gpt-3.5-turbo " ,
" messages " : [
2023-12-25 16:40:38 +08:00
{ " role " : " user " , " content " : " hi " } ,
2023-12-05 02:19:35 +08:00
] ,
" max_tokens " : 10 ,
2023-12-25 16:40:38 +08:00
" user " : " proxy-user " ,
2023-12-05 02:19:35 +08:00
}
2023-12-25 16:40:38 +08:00
2023-12-05 02:19:35 +08:00
litellm . callbacks = [ customHandler ]
print ( " testing proxy server: optional params " )
2023-12-12 13:30:02 +08:00
response = client_no_auth . post ( " /v1/chat/completions " , json = test_data )
2024-05-03 04:36:23 +08:00
mock_acompletion . assert_called_once_with (
model = " gpt-3.5-turbo " ,
messages = [
{ " role " : " user " , " content " : " hi " } ,
] ,
max_tokens = 10 ,
user = " proxy-user " ,
litellm_call_id = mock . ANY ,
litellm_logging_obj = mock . ANY ,
request_timeout = mock . ANY ,
specific_deployment = True ,
metadata = mock . ANY ,
proxy_server_request = mock . ANY ,
2025-07-20 07:13:03 +08:00
secret_fields = mock . ANY ,
2024-05-03 04:36:23 +08:00
)
2023-12-05 02:19:35 +08:00
assert response . status_code == 200
result = response . json ( )
print ( f " Received response: { result } " )
except Exception as e :
pytest . fail ( " LiteLLM Proxy test failed. Exception " , e )
2023-12-25 16:40:38 +08:00
2023-12-05 02:19:35 +08:00
# Run the test
2023-12-05 05:16:19 +08:00
# test_chat_completion_optional_params()
2024-07-27 10:03:42 +08:00
2023-12-25 16:40:38 +08:00
# Test Reading config.yaml file
2024-01-04 18:41:23 +08:00
from litellm . proxy . proxy_server import ProxyConfig
2023-12-05 05:16:19 +08:00
2023-12-25 16:40:38 +08:00
2024-08-25 10:32:22 +08:00
@pytest.mark.skip ( reason = " local variable conflicts. needs to be refactored. " )
2024-05-12 07:55:57 +08:00
@mock.patch ( " litellm.proxy.proxy_server.litellm.Cache " )
def test_load_router_config ( mock_cache , fake_env_vars ) :
mock_cache . return_value . cache . __dict__ = { " redis_client " : None }
mock_cache . return_value . supported_call_types = [
" completion " ,
" acompletion " ,
" embedding " ,
" aembedding " ,
" atranscription " ,
" transcription " ,
]
2023-12-05 05:16:19 +08:00
try :
2024-01-05 16:07:31 +08:00
import asyncio
2023-12-05 05:16:19 +08:00
print ( " testing reading config " )
2023-12-05 05:24:35 +08:00
# this is a basic config.yaml with only a model
2023-12-05 07:24:46 +08:00
filepath = os . path . dirname ( os . path . abspath ( __file__ ) )
2024-01-04 18:41:23 +08:00
proxy_config = ProxyConfig ( )
2024-01-05 16:07:31 +08:00
result = asyncio . run (
proxy_config . load_config (
router = None ,
config_file_path = f " { filepath } /example_config_yaml/simple_config.yaml " ,
)
2023-12-25 16:40:38 +08:00
)
2023-12-05 05:16:19 +08:00
print ( result )
assert len ( result [ 1 ] ) == 1
2023-12-05 05:24:35 +08:00
# this is a load balancing config yaml
2024-01-05 16:07:31 +08:00
result = asyncio . run (
proxy_config . load_config (
router = None ,
config_file_path = f " { filepath } /example_config_yaml/azure_config.yaml " ,
)
2023-12-25 16:40:38 +08:00
)
2023-12-05 05:24:35 +08:00
print ( result )
assert len ( result [ 1 ] ) == 2
2023-12-05 06:49:59 +08:00
# config with general settings - custom callbacks
2024-01-05 16:07:31 +08:00
result = asyncio . run (
proxy_config . load_config (
router = None ,
config_file_path = f " { filepath } /example_config_yaml/azure_config.yaml " ,
)
2023-12-25 16:40:38 +08:00
)
2023-12-05 06:49:59 +08:00
print ( result )
assert len ( result [ 1 ] ) == 2
2023-12-05 05:24:35 +08:00
2023-12-16 17:15:06 +08:00
# tests for litellm.cache set from config
print ( " testing reading proxy config for cache " )
litellm . cache = None
2024-01-05 16:07:31 +08:00
asyncio . run (
proxy_config . load_config (
router = None ,
config_file_path = f " { filepath } /example_config_yaml/cache_no_params.yaml " ,
)
2023-12-16 17:15:06 +08:00
)
assert litellm . cache is not None
2023-12-25 16:40:38 +08:00
assert " redis_client " in vars (
litellm . cache . cache
) # it should default to redis on proxy
assert litellm . cache . supported_call_types == [
" completion " ,
" acompletion " ,
" embedding " ,
" aembedding " ,
2024-03-10 10:47:20 +08:00
" atranscription " ,
" transcription " ,
2023-12-25 16:40:38 +08:00
] # init with all call types
2024-01-05 16:07:31 +08:00
litellm . disable_cache ( )
2023-12-16 17:15:06 +08:00
print ( " testing reading proxy config for cache with params " )
2024-05-12 07:55:57 +08:00
mock_cache . return_value . supported_call_types = [
" embedding " ,
" aembedding " ,
]
2024-01-05 16:07:31 +08:00
asyncio . run (
proxy_config . load_config (
router = None ,
config_file_path = f " { filepath } /example_config_yaml/cache_with_params.yaml " ,
)
2023-12-16 17:15:06 +08:00
)
assert litellm . cache is not None
print ( litellm . cache )
print ( litellm . cache . supported_call_types )
print ( vars ( litellm . cache . cache ) )
2023-12-25 16:40:38 +08:00
assert " redis_client " in vars (
litellm . cache . cache
) # it should default to redis on proxy
assert litellm . cache . supported_call_types == [
" embedding " ,
" aembedding " ,
] # init with all call types
2023-12-16 17:15:06 +08:00
2023-12-05 05:16:19 +08:00
except Exception as e :
2024-04-20 10:22:24 +08:00
pytest . fail (
f " Proxy: Got exception reading config: { str ( e ) } \n { traceback . format_exc ( ) } "
)
2023-12-25 16:40:38 +08:00
# test_load_router_config()
2024-07-25 09:14:49 +08:00
@pytest.mark.asyncio
async def test_team_update_redis ( ) :
"""
Tests if team update , updates the redis cache if set
"""
2024-10-14 19:04:01 +08:00
from litellm . caching . caching import DualCache , RedisCache
2024-08-01 02:49:07 +08:00
from litellm . proxy . _types import LiteLLM_TeamTableCachedObj
2024-07-25 09:14:49 +08:00
from litellm . proxy . auth . auth_checks import _cache_team_object
proxy_logging_obj : ProxyLogging = getattr (
litellm . proxy . proxy_server , " proxy_logging_obj "
)
2026-02-20 12:00:58 +08:00
redis_cache = RedisCache ( host = " localhost " )
2024-07-25 09:14:49 +08:00
with patch . object (
2024-09-26 10:56:17 +08:00
redis_cache ,
2024-07-25 09:14:49 +08:00
" async_set_cache " ,
2024-08-08 06:37:02 +08:00
new = AsyncMock ( ) ,
2024-07-25 09:14:49 +08:00
) as mock_client :
await _cache_team_object (
team_id = " 1234 " ,
2024-09-15 01:02:55 +08:00
team_table = LiteLLM_TeamTableCachedObj ( team_id = " 1234 " ) ,
2024-09-26 10:56:17 +08:00
user_api_key_cache = DualCache ( redis_cache = redis_cache ) ,
2024-07-25 09:14:49 +08:00
proxy_logging_obj = proxy_logging_obj ,
)
2024-08-08 06:37:02 +08:00
mock_client . assert_called ( )
2024-07-25 09:14:49 +08:00
@pytest.mark.asyncio
async def test_get_team_redis ( client_no_auth ) :
"""
Tests if get_team_object gets value from redis cache , if set
"""
2024-10-14 19:04:01 +08:00
from litellm . caching . caching import DualCache , RedisCache
2024-09-15 01:02:55 +08:00
from litellm . proxy . auth . auth_checks import get_team_object
2024-07-25 09:14:49 +08:00
proxy_logging_obj : ProxyLogging = getattr (
litellm . proxy . proxy_server , " proxy_logging_obj "
)
2024-09-26 10:56:17 +08:00
redis_cache = RedisCache ( )
2024-07-25 09:14:49 +08:00
2025-11-23 06:21:58 +08:00
from fastapi import HTTPException
2024-07-25 09:14:49 +08:00
with patch . object (
2024-09-26 10:56:17 +08:00
redis_cache ,
2024-07-25 09:14:49 +08:00
" async_get_cache " ,
new = AsyncMock ( ) ,
) as mock_client :
try :
await get_team_object (
team_id = " 1234 " ,
2024-09-26 10:56:17 +08:00
user_api_key_cache = DualCache ( redis_cache = redis_cache ) ,
2024-07-25 09:14:49 +08:00
parent_otel_span = None ,
proxy_logging_obj = proxy_logging_obj ,
2024-08-08 06:37:02 +08:00
prisma_client = AsyncMock ( ) ,
2024-07-25 09:14:49 +08:00
)
2025-11-23 06:21:58 +08:00
except HTTPException :
2024-07-25 09:14:49 +08:00
pass
mock_client . assert_called_once ( )
2024-08-08 09:50:40 +08:00
import random
2025-09-26 06:47:01 +08:00
from litellm . _uuid import uuid
2024-08-09 10:14:43 +08:00
from unittest . mock import AsyncMock , MagicMock , PropertyMock , patch
2024-08-08 09:50:40 +08:00
2024-08-09 10:14:43 +08:00
from litellm . proxy . _types import (
LitellmUserRoles ,
NewUserRequest ,
TeamMemberAddRequest ,
UserAPIKeyAuth ,
)
2024-08-08 09:50:40 +08:00
from litellm . proxy . management_endpoints . internal_user_endpoints import new_user
2024-08-09 10:14:43 +08:00
from litellm . proxy . management_endpoints . team_endpoints import team_member_add
2024-10-02 01:49:22 +08:00
from test_key_generate_prisma import prisma_client
2024-08-08 09:50:40 +08:00
2026-06-05 05:56:02 +08:00
@pytest.fixture
def mock_prisma_client ( ) :
client = MagicMock ( )
client . connect = AsyncMock ( )
client . disconnect = AsyncMock ( )
return client
2026-02-20 22:28:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-08-09 08:59:30 +08:00
@pytest.mark.parametrize (
" user_role " ,
[ LitellmUserRoles . INTERNAL_USER . value , LitellmUserRoles . PROXY_ADMIN . value ] ,
)
2024-08-08 09:50:40 +08:00
@pytest.mark.asyncio
2026-02-21 00:25:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-08-09 08:59:30 +08:00
async def test_create_user_default_budget ( prisma_client , user_role ) :
2024-08-08 09:50:40 +08:00
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
2024-08-08 09:59:46 +08:00
setattr ( litellm , " max_internal_user_budget " , 10 )
2024-08-09 08:59:30 +08:00
setattr ( litellm , " internal_user_budget_duration " , " 5m " )
2024-08-08 09:50:40 +08:00
await litellm . proxy . proxy_server . prisma_client . connect ( )
user = f " ishaan { uuid . uuid4 ( ) . hex } "
2024-08-09 08:59:30 +08:00
request = NewUserRequest (
user_id = user , user_role = user_role
) # create a key with no budget
2024-08-08 09:50:40 +08:00
with patch . object (
litellm . proxy . proxy_server . prisma_client , " insert_data " , new = AsyncMock ( )
) as mock_client :
await new_user (
request ,
)
mock_client . assert_called ( )
print ( f " mock_client.call_args: { mock_client . call_args } " )
print ( " mock_client.call_args.kwargs: {} " . format ( mock_client . call_args . kwargs ) )
2024-08-09 08:59:30 +08:00
if user_role == LitellmUserRoles . INTERNAL_USER . value :
assert (
mock_client . call_args . kwargs [ " data " ] [ " max_budget " ]
== litellm . max_internal_user_budget
)
assert (
mock_client . call_args . kwargs [ " data " ] [ " budget_duration " ]
== litellm . internal_user_budget_duration
)
else :
assert mock_client . call_args . kwargs [ " data " ] [ " max_budget " ] is None
assert mock_client . call_args . kwargs [ " data " ] [ " budget_duration " ] is None
2024-08-09 10:14:43 +08:00
@pytest.mark.parametrize ( " new_member_method " , [ " user_id " , " user_email " ] )
@pytest.mark.asyncio
2026-02-21 00:25:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-08-09 10:14:43 +08:00
async def test_create_team_member_add ( prisma_client , new_member_method ) :
import time
2024-08-10 03:15:45 +08:00
from fastapi import Request
2024-08-25 10:32:22 +08:00
from litellm . proxy . _types import LiteLLM_TeamTableCachedObj , LiteLLM_UserTable
2024-08-09 10:14:43 +08:00
from litellm . proxy . proxy_server import hash_token , user_api_key_cache
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
setattr ( litellm , " max_internal_user_budget " , 10 )
setattr ( litellm , " internal_user_budget_duration " , " 5m " )
await litellm . proxy . proxy_server . prisma_client . connect ( )
user = f " ishaan { uuid . uuid4 ( ) . hex } "
_team_id = " litellm-test-client-id-new "
team_obj = LiteLLM_TeamTableCachedObj (
team_id = _team_id ,
blocked = False ,
last_refreshed_at = time . time ( ) ,
metadata = { " guardrails " : { " modify_guardrails " : False } } ,
)
# user_api_key_cache.set_cache(key=hash_token(user_key), value=valid_token)
user_api_key_cache . set_cache ( key = " team_id: {} " . format ( _team_id ) , value = team_obj )
setattr ( litellm . proxy . proxy_server , " user_api_key_cache " , user_api_key_cache )
if new_member_method == " user_id " :
data = {
" team_id " : _team_id ,
" member " : [ { " role " : " user " , " user_id " : user } ] ,
}
elif new_member_method == " user_email " :
data = {
" team_id " : _team_id ,
" member " : [ { " role " : " user " , " user_email " : user } ] ,
}
team_member_add_request = TeamMemberAddRequest ( * * data )
2026-04-18 04:02:59 +08:00
with (
patch (
" litellm.proxy.proxy_server.prisma_client.db.litellm_usertable " ,
new_callable = AsyncMock ,
) as mock_litellm_usertable ,
patch (
" litellm.proxy.auth.auth_checks._get_team_object_from_user_api_key_cache " ,
new = AsyncMock ( return_value = team_obj ) ,
) as mock_team_obj ,
patch (
" litellm.proxy.proxy_server.prisma_client.get_data " ,
new = AsyncMock ( return_value = [ ] ) ,
) as mock_get_data ,
) :
2024-11-26 16:49:24 +08:00
2024-08-25 10:32:22 +08:00
mock_client = AsyncMock (
return_value = LiteLLM_UserTable (
user_id = " 1234 " , max_budget = 100 , user_email = " 1234 "
)
)
2024-08-09 10:14:43 +08:00
mock_litellm_usertable . upsert = mock_client
mock_litellm_usertable . find_many = AsyncMock ( return_value = None )
2026-01-27 12:07:30 +08:00
# Mock find_first for user_email validation (returns None for new users)
mock_litellm_usertable . find_first = AsyncMock ( return_value = None )
# Mock find_unique for user_id validation (returns None for new users)
mock_litellm_usertable . find_unique = AsyncMock ( return_value = None )
2024-08-25 10:32:22 +08:00
team_mock_client = AsyncMock ( )
original_val = getattr (
litellm . proxy . proxy_server . prisma_client . db , " litellm_teamtable "
)
litellm . proxy . proxy_server . prisma_client . db . litellm_teamtable = team_mock_client
2024-09-15 01:02:55 +08:00
team_mock_client . update = AsyncMock (
return_value = LiteLLM_TeamTableCachedObj ( team_id = " 1234 " )
)
2024-08-09 10:14:43 +08:00
2025-06-21 14:11:53 +08:00
print ( f " team_member_add_request= { team_member_add_request } " )
2024-08-09 10:14:43 +08:00
await team_member_add (
2024-08-10 03:15:45 +08:00
data = team_member_add_request ,
2024-08-21 23:37:04 +08:00
user_api_key_dict = UserAPIKeyAuth ( user_role = " proxy_admin " ) ,
2024-08-09 10:14:43 +08:00
)
mock_client . assert_called ( )
print ( f " mock_client.call_args: { mock_client . call_args } " )
print ( " mock_client.call_args.kwargs: {} " . format ( mock_client . call_args . kwargs ) )
assert (
mock_client . call_args . kwargs [ " data " ] [ " create " ] [ " max_budget " ]
== litellm . max_internal_user_budget
)
assert (
mock_client . call_args . kwargs [ " data " ] [ " create " ] [ " budget_duration " ]
== litellm . internal_user_budget_duration
)
2024-08-13 09:47:25 +08:00
2024-08-25 10:32:22 +08:00
litellm . proxy . proxy_server . prisma_client . db . litellm_teamtable = original_val
2024-08-13 09:47:25 +08:00
2024-08-21 05:01:12 +08:00
@pytest.mark.parametrize ( " team_member_role " , [ " admin " , " user " ] )
2024-08-21 07:25:13 +08:00
@pytest.mark.parametrize ( " team_route " , [ " /team/member_add " , " /team/member_delete " ] )
2024-08-21 05:01:12 +08:00
@pytest.mark.asyncio
async def test_create_team_member_add_team_admin_user_api_key_auth (
2024-08-21 07:25:13 +08:00
prisma_client , team_member_role , team_route
2024-08-21 05:01:12 +08:00
) :
import time
from fastapi import Request
from litellm . proxy . _types import LiteLLM_TeamTableCachedObj , Member
from litellm . proxy . proxy_server import (
ProxyException ,
hash_token ,
user_api_key_auth ,
user_api_key_cache ,
)
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
setattr ( litellm , " max_internal_user_budget " , 10 )
setattr ( litellm , " internal_user_budget_duration " , " 5m " )
user = f " ishaan { uuid . uuid4 ( ) . hex } "
_team_id = " litellm-test-client-id-new "
user_key = " sk-12345678 "
valid_token = UserAPIKeyAuth (
team_id = _team_id ,
token = hash_token ( user_key ) ,
team_member = Member ( role = team_member_role , user_id = user ) ,
last_refreshed_at = time . time ( ) ,
)
user_api_key_cache . set_cache ( key = hash_token ( user_key ) , value = valid_token )
team_obj = LiteLLM_TeamTableCachedObj (
team_id = _team_id ,
blocked = False ,
last_refreshed_at = time . time ( ) ,
metadata = { " guardrails " : { " modify_guardrails " : False } } ,
)
user_api_key_cache . set_cache ( key = " team_id: {} " . format ( _team_id ) , value = team_obj )
setattr ( litellm . proxy . proxy_server , " user_api_key_cache " , user_api_key_cache )
## TEST IF TEAM ADMIN ALLOWED TO CALL /MEMBER_ADD ENDPOINT
import json
from starlette . datastructures import URL
request = Request ( scope = { " type " : " http " } )
2024-08-21 07:25:13 +08:00
request . _url = URL ( url = team_route )
2024-08-21 05:01:12 +08:00
body = { }
json_bytes = json . dumps ( body ) . encode ( " utf-8 " )
request . _body = json_bytes
2024-08-21 07:57:18 +08:00
## ALLOWED BY USER_API_KEY_AUTH
await user_api_key_auth ( request = request , api_key = " Bearer " + user_key )
2024-08-21 05:01:12 +08:00
@pytest.mark.parametrize ( " new_member_method " , [ " user_id " , " user_email " ] )
2024-08-21 07:57:18 +08:00
@pytest.mark.parametrize ( " user_role " , [ " admin " , " user " ] )
2024-08-21 05:01:12 +08:00
@pytest.mark.asyncio
2024-08-21 07:57:18 +08:00
async def test_create_team_member_add_team_admin (
prisma_client , new_member_method , user_role
) :
2024-08-21 05:01:12 +08:00
"""
Relevant issue - https : / / github . com / BerriAI / litellm / issues / 5300
Allow team admins to :
- Add and remove team members
- raise error if team member not an existing ' internal_user '
"""
import time
from fastapi import Request
2024-08-25 10:32:22 +08:00
from litellm . proxy . _types import (
LiteLLM_TeamTableCachedObj ,
LiteLLM_UserTable ,
Member ,
)
2024-08-21 05:01:12 +08:00
from litellm . proxy . proxy_server import (
2024-08-21 07:57:18 +08:00
HTTPException ,
2024-08-21 05:01:12 +08:00
ProxyException ,
hash_token ,
user_api_key_auth ,
user_api_key_cache ,
)
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
setattr ( litellm , " max_internal_user_budget " , 10 )
setattr ( litellm , " internal_user_budget_duration " , " 5m " )
user = f " ishaan { uuid . uuid4 ( ) . hex } "
_team_id = " litellm-test-client-id-new "
user_key = " sk-12345678 "
2025-02-02 03:23:00 +08:00
team_admin = f " krrish { uuid . uuid4 ( ) . hex } "
2024-08-21 05:01:12 +08:00
valid_token = UserAPIKeyAuth (
team_id = _team_id ,
2025-02-02 03:23:00 +08:00
user_id = team_admin ,
2024-08-21 05:01:12 +08:00
token = hash_token ( user_key ) ,
last_refreshed_at = time . time ( ) ,
)
user_api_key_cache . set_cache ( key = hash_token ( user_key ) , value = valid_token )
team_obj = LiteLLM_TeamTableCachedObj (
team_id = _team_id ,
blocked = False ,
last_refreshed_at = time . time ( ) ,
2025-02-02 03:23:00 +08:00
members_with_roles = [ Member ( role = user_role , user_id = team_admin ) ] ,
2024-08-21 05:01:12 +08:00
metadata = { " guardrails " : { " modify_guardrails " : False } } ,
)
user_api_key_cache . set_cache ( key = " team_id: {} " . format ( _team_id ) , value = team_obj )
setattr ( litellm . proxy . proxy_server , " user_api_key_cache " , user_api_key_cache )
if new_member_method == " user_id " :
data = {
" team_id " : _team_id ,
" member " : [ { " role " : " user " , " user_id " : user } ] ,
}
elif new_member_method == " user_email " :
data = {
" team_id " : _team_id ,
" member " : [ { " role " : " user " , " user_email " : user } ] ,
}
team_member_add_request = TeamMemberAddRequest ( * * data )
2026-04-18 04:02:59 +08:00
with (
patch (
" litellm.proxy.proxy_server.prisma_client.db.litellm_usertable " ,
new_callable = AsyncMock ,
) as mock_litellm_usertable ,
patch (
" litellm.proxy.auth.auth_checks._get_team_object_from_user_api_key_cache " ,
new = AsyncMock ( return_value = team_obj ) ,
) as mock_team_obj ,
patch (
" litellm.proxy.proxy_server.prisma_client.get_data " ,
new = AsyncMock ( return_value = [ ] ) ,
) as mock_get_data ,
) :
2024-08-25 10:32:22 +08:00
mock_client = AsyncMock (
return_value = LiteLLM_UserTable (
user_id = " 1234 " , max_budget = 100 , user_email = " 1234 "
)
)
2024-08-21 05:01:12 +08:00
mock_litellm_usertable . upsert = mock_client
mock_litellm_usertable . find_many = AsyncMock ( return_value = None )
2026-01-27 12:07:30 +08:00
# Mock find_first for user_email validation (returns None for new users)
mock_litellm_usertable . find_first = AsyncMock ( return_value = None )
# Mock find_unique for user_id validation (returns None for new users)
mock_litellm_usertable . find_unique = AsyncMock ( return_value = None )
2024-08-21 05:01:12 +08:00
2024-08-25 10:32:22 +08:00
team_mock_client = AsyncMock ( )
original_val = getattr (
litellm . proxy . proxy_server . prisma_client . db , " litellm_teamtable "
)
litellm . proxy . proxy_server . prisma_client . db . litellm_teamtable = team_mock_client
2024-09-15 01:02:55 +08:00
team_mock_client . update = AsyncMock (
return_value = LiteLLM_TeamTableCachedObj ( team_id = " 1234 " )
)
2024-08-25 10:32:22 +08:00
2024-08-21 07:57:18 +08:00
try :
await team_member_add (
data = team_member_add_request ,
user_api_key_dict = valid_token ,
)
except HTTPException as e :
if user_role == " user " :
assert e . status_code == 403
2025-02-18 09:55:05 +08:00
return
2024-08-21 07:57:18 +08:00
else :
raise e
2024-08-21 05:01:12 +08:00
mock_client . assert_called ( )
print ( f " mock_client.call_args: { mock_client . call_args } " )
print ( " mock_client.call_args.kwargs: {} " . format ( mock_client . call_args . kwargs ) )
assert (
mock_client . call_args . kwargs [ " data " ] [ " create " ] [ " max_budget " ]
== litellm . max_internal_user_budget
)
assert (
mock_client . call_args . kwargs [ " data " ] [ " create " ] [ " budget_duration " ]
== litellm . internal_user_budget_duration
)
2024-08-25 10:32:22 +08:00
litellm . proxy . proxy_server . prisma_client . db . litellm_teamtable = original_val
2024-08-21 05:01:12 +08:00
2024-08-13 09:47:25 +08:00
@pytest.mark.asyncio
2026-02-21 00:25:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-08-13 09:47:25 +08:00
async def test_user_info_team_list ( prisma_client ) :
""" Assert user_info for admin calls team_list function """
from litellm . proxy . _types import LiteLLM_UserTable
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
await litellm . proxy . proxy_server . prisma_client . connect ( )
from litellm . proxy . management_endpoints . internal_user_endpoints import user_info
with patch (
" litellm.proxy.management_endpoints.team_endpoints.list_team " ,
new_callable = AsyncMock ,
) as mock_client :
prisma_client . get_data = AsyncMock (
return_value = LiteLLM_UserTable (
user_role = " proxy_admin " ,
user_id = " default_user_id " ,
max_budget = None ,
user_email = " " ,
)
)
try :
await user_info (
2025-06-11 13:13:10 +08:00
request = MagicMock ( ) ,
2024-08-13 09:47:25 +08:00
user_id = None ,
user_api_key_dict = UserAPIKeyAuth (
api_key = " sk-1234 " , user_id = " default_user_id "
) ,
)
except Exception :
pass
mock_client . assert_called ( )
2024-08-13 12:21:40 +08:00
2024-08-14 12:27:59 +08:00
2024-08-14 12:36:16 +08:00
@pytest.mark.skip ( reason = " Local test " )
2024-08-13 12:21:40 +08:00
@pytest.mark.asyncio
async def test_add_callback_via_key ( prisma_client ) :
"""
Test if callback specified in key , is used .
"""
global headers
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . proxy_server import chat_completion
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
await litellm . proxy . proxy_server . prisma_client . connect ( )
litellm . set_verbose = True
try :
# Your test data
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-08-13 12:21:40 +08:00
" messages " : [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
}
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /chat/completions " )
json_bytes = json . dumps ( test_data ) . encode ( " utf-8 " )
request . _body = json_bytes
with patch . object (
litellm . litellm_core_utils . litellm_logging ,
" LangFuseLogger " ,
new = MagicMock ( ) ,
) as mock_client :
resp = await chat_completion (
request = request ,
fastapi_response = Response ( ) ,
user_api_key_dict = UserAPIKeyAuth (
metadata = {
2026-04-30 13:35:17 +08:00
" allow_client_mock_response " : True ,
2024-08-13 12:21:40 +08:00
" logging " : [
{
" callback_name " : " langfuse " , # 'otel', 'langfuse', 'lunary'
" callback_type " : " success " , # set, if required by integration - future improvement, have logging tools work for success + failure by default
" callback_vars " : {
" langfuse_public_key " : " os.environ/LANGFUSE_PUBLIC_KEY " ,
" langfuse_secret_key " : " os.environ/LANGFUSE_SECRET_KEY " ,
" langfuse_host " : " https://us.cloud.langfuse.com " ,
} ,
}
2026-04-30 13:35:17 +08:00
] ,
2024-08-13 12:21:40 +08:00
}
) ,
)
print ( resp )
mock_client . assert_called ( )
mock_client . return_value . log_event . assert_called ( )
args , kwargs = mock_client . return_value . log_event . call_args
kwargs = kwargs [ " kwargs " ]
assert " user_api_key_metadata " in kwargs [ " litellm_params " ] [ " metadata " ]
assert (
" logging "
in kwargs [ " litellm_params " ] [ " metadata " ] [ " user_api_key_metadata " ]
)
checked_keys = False
for item in kwargs [ " litellm_params " ] [ " metadata " ] [ " user_api_key_metadata " ] [
" logging "
] :
for k , v in item [ " callback_vars " ] . items ( ) :
print ( " k= {} , v= {} " . format ( k , v ) )
if " key " in k :
assert " os.environ " in v
checked_keys = True
assert checked_keys
except Exception as e :
2024-08-14 12:27:59 +08:00
pytest . fail ( f " LiteLLM Proxy test failed. Exception - { str ( e ) } " )
@pytest.mark.asyncio
2024-09-10 07:44:37 +08:00
@pytest.mark.parametrize (
" callback_type, expected_success_callbacks, expected_failure_callbacks " ,
[
( " success " , [ " langfuse " ] , [ ] ) ,
( " failure " , [ ] , [ " langfuse " ] ) ,
( " success_and_failure " , [ " langfuse " ] , [ " langfuse " ] ) ,
] ,
)
async def test_add_callback_via_key_litellm_pre_call_utils (
2026-06-05 05:56:02 +08:00
mock_prisma_client ,
callback_type ,
expected_success_callbacks ,
expected_failure_callbacks ,
2024-09-10 07:44:37 +08:00
) :
2024-08-14 12:27:59 +08:00
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . litellm_pre_call_utils import add_litellm_data_to_request
2026-06-05 05:56:02 +08:00
setattr ( litellm . proxy . proxy_server , " prisma_client " , mock_prisma_client )
2024-08-14 12:27:59 +08:00
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /chat/completions " )
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-08-14 12:27:59 +08:00
" messages " : [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
}
json_bytes = json . dumps ( test_data ) . encode ( " utf-8 " )
request . _body = json_bytes
data = {
" data " : {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-08-14 12:27:59 +08:00
" messages " : [ { " role " : " user " , " content " : " write 1 sentence poem " } ] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
} ,
" request " : request ,
" user_api_key_dict " : UserAPIKeyAuth (
token = None ,
key_name = None ,
key_alias = None ,
spend = 0.0 ,
max_budget = None ,
expires = None ,
models = [ ] ,
aliases = { } ,
config = { } ,
user_id = None ,
team_id = None ,
max_parallel_requests = None ,
metadata = {
2026-04-30 13:35:17 +08:00
" allow_client_mock_response " : True ,
2024-08-14 12:27:59 +08:00
" logging " : [
{
" callback_name " : " langfuse " ,
2024-09-10 07:44:37 +08:00
" callback_type " : callback_type ,
2024-08-14 12:27:59 +08:00
" callback_vars " : {
2024-08-22 04:36:33 +08:00
" langfuse_public_key " : " my-mock-public-key " ,
" langfuse_secret_key " : " my-mock-secret-key " ,
2024-08-14 12:27:59 +08:00
" langfuse_host " : " https://us.cloud.langfuse.com " ,
} ,
}
2026-04-30 13:35:17 +08:00
] ,
2024-08-14 12:27:59 +08:00
} ,
tpm_limit = None ,
rpm_limit = None ,
budget_duration = None ,
budget_reset_at = None ,
allowed_cache_controls = [ ] ,
permissions = { } ,
model_spend = { } ,
model_max_budget = { } ,
soft_budget_cooldown = False ,
litellm_budget_table = None ,
org_id = None ,
team_spend = None ,
team_alias = None ,
team_tpm_limit = None ,
team_rpm_limit = None ,
team_max_budget = None ,
team_models = [ ] ,
team_blocked = False ,
soft_budget = None ,
team_model_aliases = None ,
team_member_spend = None ,
team_metadata = None ,
end_user_id = None ,
end_user_tpm_limit = None ,
end_user_rpm_limit = None ,
end_user_max_budget = None ,
last_refreshed_at = None ,
api_key = None ,
user_role = None ,
allowed_model_region = None ,
parent_otel_span = None ,
) ,
" proxy_config " : proxy_config ,
" general_settings " : { } ,
" version " : " 0.0.0 " ,
}
new_data = await add_litellm_data_to_request ( * * data )
2024-09-10 07:44:37 +08:00
print ( " NEW DATA: {} " . format ( new_data ) )
2024-08-14 12:27:59 +08:00
assert " langfuse_public_key " in new_data
2024-08-22 04:36:33 +08:00
assert new_data [ " langfuse_public_key " ] == " my-mock-public-key "
2024-08-14 12:27:59 +08:00
assert " langfuse_secret_key " in new_data
2024-08-22 04:36:33 +08:00
assert new_data [ " langfuse_secret_key " ] == " my-mock-secret-key "
2024-08-18 01:46:59 +08:00
2024-09-10 07:44:37 +08:00
if expected_success_callbacks :
assert " success_callback " in new_data
assert new_data [ " success_callback " ] == expected_success_callbacks
if expected_failure_callbacks :
assert " failure_callback " in new_data
assert new_data [ " failure_callback " ] == expected_failure_callbacks
2024-08-18 01:46:59 +08:00
2024-11-15 03:32:54 +08:00
@pytest.mark.asyncio
@pytest.mark.parametrize (
" disable_fallbacks_set " ,
[
True ,
False ,
] ,
)
async def test_disable_fallbacks_by_key ( disable_fallbacks_set ) :
from litellm . proxy . litellm_pre_call_utils import LiteLLMProxyRequestSetup
key_metadata = { " disable_fallbacks " : disable_fallbacks_set }
existing_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-11-15 03:32:54 +08:00
" messages " : [ { " role " : " user " , " content " : " write 1 sentence poem " } ] ,
}
data = LiteLLMProxyRequestSetup . add_key_level_controls (
key_metadata = key_metadata ,
data = existing_data ,
_metadata_variable_name = " metadata " ,
)
assert data [ " disable_fallbacks " ] == disable_fallbacks_set
2024-10-04 14:26:10 +08:00
@pytest.mark.asyncio
@pytest.mark.parametrize (
" callback_type, expected_success_callbacks, expected_failure_callbacks " ,
[
( " success " , [ " gcs_bucket " ] , [ ] ) ,
( " failure " , [ ] , [ " gcs_bucket " ] ) ,
( " success_and_failure " , [ " gcs_bucket " ] , [ " gcs_bucket " ] ) ,
] ,
)
async def test_add_callback_via_key_litellm_pre_call_utils_gcs_bucket (
2026-06-05 05:56:02 +08:00
mock_prisma_client ,
callback_type ,
expected_success_callbacks ,
expected_failure_callbacks ,
2024-10-04 14:26:10 +08:00
) :
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . litellm_pre_call_utils import add_litellm_data_to_request
2026-06-05 05:56:02 +08:00
setattr ( litellm . proxy . proxy_server , " prisma_client " , mock_prisma_client )
2024-10-04 14:26:10 +08:00
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /chat/completions " )
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-10-04 14:26:10 +08:00
" messages " : [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
}
json_bytes = json . dumps ( test_data ) . encode ( " utf-8 " )
request . _body = json_bytes
data = {
" data " : {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-10-04 14:26:10 +08:00
" messages " : [ { " role " : " user " , " content " : " write 1 sentence poem " } ] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
} ,
" request " : request ,
" user_api_key_dict " : UserAPIKeyAuth (
token = None ,
key_name = None ,
key_alias = None ,
spend = 0.0 ,
max_budget = None ,
expires = None ,
models = [ ] ,
aliases = { } ,
config = { } ,
user_id = None ,
team_id = None ,
max_parallel_requests = None ,
metadata = {
2026-04-30 13:35:17 +08:00
" allow_client_mock_response " : True ,
2024-10-04 14:26:10 +08:00
" logging " : [
{
" callback_name " : " gcs_bucket " ,
" callback_type " : callback_type ,
" callback_vars " : {
" gcs_bucket_name " : " key-logging-project1 " ,
2025-01-06 06:00:17 +08:00
" gcs_path_service_account " : " pathrise-convert-1606954137718-a956eef1a2a8.json " ,
2024-10-04 14:26:10 +08:00
} ,
}
2026-04-30 13:35:17 +08:00
] ,
2024-10-04 14:26:10 +08:00
} ,
tpm_limit = None ,
rpm_limit = None ,
budget_duration = None ,
budget_reset_at = None ,
allowed_cache_controls = [ ] ,
permissions = { } ,
model_spend = { } ,
model_max_budget = { } ,
soft_budget_cooldown = False ,
litellm_budget_table = None ,
org_id = None ,
team_spend = None ,
team_alias = None ,
team_tpm_limit = None ,
team_rpm_limit = None ,
team_max_budget = None ,
team_models = [ ] ,
team_blocked = False ,
soft_budget = None ,
team_model_aliases = None ,
team_member_spend = None ,
team_metadata = None ,
end_user_id = None ,
end_user_tpm_limit = None ,
end_user_rpm_limit = None ,
end_user_max_budget = None ,
last_refreshed_at = None ,
api_key = None ,
user_role = None ,
allowed_model_region = None ,
parent_otel_span = None ,
) ,
" proxy_config " : proxy_config ,
" general_settings " : { } ,
" version " : " 0.0.0 " ,
}
new_data = await add_litellm_data_to_request ( * * data )
print ( " NEW DATA: {} " . format ( new_data ) )
assert " gcs_bucket_name " in new_data
assert new_data [ " gcs_bucket_name " ] == " key-logging-project1 "
assert " gcs_path_service_account " in new_data
assert (
2025-01-06 06:00:17 +08:00
new_data [ " gcs_path_service_account " ]
== " pathrise-convert-1606954137718-a956eef1a2a8.json "
2024-10-04 14:26:10 +08:00
)
if expected_success_callbacks :
assert " success_callback " in new_data
assert new_data [ " success_callback " ] == expected_success_callbacks
if expected_failure_callbacks :
assert " failure_callback " in new_data
assert new_data [ " failure_callback " ] == expected_failure_callbacks
2024-11-12 05:58:06 +08:00
@pytest.mark.asyncio
@pytest.mark.parametrize (
" callback_type, expected_success_callbacks, expected_failure_callbacks " ,
[
( " success " , [ " langsmith " ] , [ ] ) ,
( " failure " , [ ] , [ " langsmith " ] ) ,
( " success_and_failure " , [ " langsmith " ] , [ " langsmith " ] ) ,
] ,
)
async def test_add_callback_via_key_litellm_pre_call_utils_langsmith (
2026-06-05 05:56:02 +08:00
mock_prisma_client ,
callback_type ,
expected_success_callbacks ,
expected_failure_callbacks ,
2024-11-12 05:58:06 +08:00
) :
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . litellm_pre_call_utils import add_litellm_data_to_request
2026-06-05 05:56:02 +08:00
setattr ( litellm . proxy . proxy_server , " prisma_client " , mock_prisma_client )
2024-11-12 05:58:06 +08:00
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /chat/completions " )
test_data = {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-11-12 05:58:06 +08:00
" messages " : [
{ " role " : " user " , " content " : " write 1 sentence poem " } ,
] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
}
json_bytes = json . dumps ( test_data ) . encode ( " utf-8 " )
request . _body = json_bytes
data = {
" data " : {
2025-10-26 01:19:24 +08:00
" model " : " azure/gpt-4.1-mini " ,
2024-11-12 05:58:06 +08:00
" messages " : [ { " role " : " user " , " content " : " write 1 sentence poem " } ] ,
" max_tokens " : 10 ,
" mock_response " : " Hello world " ,
" api_key " : " my-fake-key " ,
} ,
" request " : request ,
" user_api_key_dict " : UserAPIKeyAuth (
token = None ,
key_name = None ,
key_alias = None ,
spend = 0.0 ,
max_budget = None ,
expires = None ,
models = [ ] ,
aliases = { } ,
config = { } ,
user_id = None ,
team_id = None ,
max_parallel_requests = None ,
metadata = {
2026-04-30 13:35:17 +08:00
" allow_client_mock_response " : True ,
2024-11-12 05:58:06 +08:00
" logging " : [
{
" callback_name " : " langsmith " ,
" callback_type " : callback_type ,
" callback_vars " : {
" langsmith_api_key " : " ls-1234 " ,
" langsmith_project " : " pr-brief-resemblance-72 " ,
" langsmith_base_url " : " https://api.smith.langchain.com " ,
} ,
}
2026-04-30 13:35:17 +08:00
] ,
2024-11-12 05:58:06 +08:00
} ,
tpm_limit = None ,
rpm_limit = None ,
budget_duration = None ,
budget_reset_at = None ,
allowed_cache_controls = [ ] ,
permissions = { } ,
model_spend = { } ,
model_max_budget = { } ,
soft_budget_cooldown = False ,
litellm_budget_table = None ,
org_id = None ,
team_spend = None ,
team_alias = None ,
team_tpm_limit = None ,
team_rpm_limit = None ,
team_max_budget = None ,
team_models = [ ] ,
team_blocked = False ,
soft_budget = None ,
team_model_aliases = None ,
team_member_spend = None ,
team_metadata = None ,
end_user_id = None ,
end_user_tpm_limit = None ,
end_user_rpm_limit = None ,
end_user_max_budget = None ,
last_refreshed_at = None ,
api_key = None ,
user_role = None ,
allowed_model_region = None ,
parent_otel_span = None ,
) ,
" proxy_config " : proxy_config ,
" general_settings " : { } ,
" version " : " 0.0.0 " ,
}
new_data = await add_litellm_data_to_request ( * * data )
print ( " NEW DATA: {} " . format ( new_data ) )
assert " langsmith_api_key " in new_data
assert new_data [ " langsmith_api_key " ] == " ls-1234 "
assert " langsmith_project " in new_data
assert new_data [ " langsmith_project " ] == " pr-brief-resemblance-72 "
assert " langsmith_base_url " in new_data
assert new_data [ " langsmith_base_url " ] == " https://api.smith.langchain.com "
if expected_success_callbacks :
assert " success_callback " in new_data
assert new_data [ " success_callback " ] == expected_success_callbacks
if expected_failure_callbacks :
assert " failure_callback " in new_data
assert new_data [ " failure_callback " ] == expected_failure_callbacks
2026-02-20 22:28:42 +08:00
@pytest.mark.skipif (
not os . getenv ( " GEMINI_API_KEY " ) and not os . getenv ( " GOOGLE_API_KEY " ) ,
reason = " Requires GEMINI_API_KEY or GOOGLE_API_KEY. " ,
)
2024-08-18 01:46:59 +08:00
@pytest.mark.asyncio
async def test_gemini_pass_through_endpoint ( ) :
from starlette . datastructures import URL
2024-11-22 03:46:50 +08:00
from litellm . proxy . pass_through_endpoints . llm_passthrough_endpoints import (
2024-08-18 01:46:59 +08:00
Request ,
Response ,
gemini_proxy_route ,
)
body = b """
{
" contents " : [ {
" parts " : [ {
" text " : " The quick brown fox jumps over the lazy dog. "
} ]
} ]
}
"""
# Construct the scope dictionary
scope = {
" type " : " http " ,
" method " : " POST " ,
2025-09-28 08:17:12 +08:00
" path " : " /gemini/v1beta/models/gemini-2.5-flash:countTokens " ,
2024-08-18 01:46:59 +08:00
" query_string " : b " key=sk-1234 " ,
" headers " : [
( b " content-type " , b " application/json " ) ,
] ,
}
# Create a new Request object
async def async_receive ( ) :
return { " type " : " http.request " , " body " : body , " more_body " : False }
request = Request (
scope = scope ,
receive = async_receive ,
)
resp = await gemini_proxy_route (
2025-09-28 08:17:12 +08:00
endpoint = " v1beta/models/gemini-2.5-flash:countTokens?key=sk-1234 " ,
2024-08-18 01:46:59 +08:00
request = request ,
fastapi_response = Response ( ) ,
)
print ( resp . body )
2024-09-13 14:04:06 +08:00
2024-09-15 01:02:55 +08:00
@pytest.mark.parametrize ( " hidden " , [ True , False ] )
2024-09-13 14:04:06 +08:00
@pytest.mark.asyncio
2026-02-21 00:25:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-09-15 01:02:55 +08:00
async def test_proxy_model_group_alias_checks ( prisma_client , hidden ) :
2024-09-13 14:04:06 +08:00
"""
Check if model group alias is returned on
` / v1 / models `
` / v1 / model / info `
` / v1 / model_group / info `
"""
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . proxy_server import model_group_info , model_info_v1 , model_list
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
await litellm . proxy . proxy_server . prisma_client . connect ( )
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
_model_list = [
{
" model_name " : " gpt-3.5-turbo " ,
" litellm_params " : { " model " : " gpt-3.5-turbo " } ,
}
]
model_alias = " gpt-4 "
router = litellm . Router (
model_list = _model_list ,
2024-09-15 01:02:55 +08:00
model_group_alias = { model_alias : { " model " : " gpt-3.5-turbo " , " hidden " : hidden } } ,
2024-09-13 14:04:06 +08:00
)
setattr ( litellm . proxy . proxy_server , " llm_router " , router )
setattr ( litellm . proxy . proxy_server , " llm_model_list " , _model_list )
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /v1/models " )
resp = await model_list (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
2024-09-15 01:02:55 +08:00
if hidden :
assert len ( resp [ " data " ] ) == 1
else :
assert len ( resp [ " data " ] ) == 2
2024-09-13 14:04:06 +08:00
print ( resp )
resp = await model_info_v1 (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
models = resp [ " data " ]
is_model_alias_in_list = False
for item in models :
if model_alias == item [ " model_name " ] :
is_model_alias_in_list = True
2024-09-15 01:02:55 +08:00
if hidden :
assert is_model_alias_in_list is False
else :
assert is_model_alias_in_list
2024-09-13 14:04:06 +08:00
resp = await model_group_info (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
2025-01-01 15:21:51 +08:00
print ( f " resp: { resp } " )
2024-09-13 14:04:06 +08:00
models = resp [ " data " ]
is_model_alias_in_list = False
2025-01-01 15:21:51 +08:00
print ( f " model_alias: { model_alias } , models: { models } " )
2024-09-13 14:04:06 +08:00
for item in models :
if model_alias == item . model_group :
is_model_alias_in_list = True
2024-09-15 01:02:55 +08:00
if hidden :
assert is_model_alias_in_list is False
else :
assert is_model_alias_in_list , f " models: { models } "
2024-09-29 01:54:43 +08:00
@pytest.mark.asyncio
2026-02-21 00:25:42 +08:00
@pytest.mark.skip ( reason = " Requires reliable external DB connection (prisma). " )
2024-09-29 01:54:43 +08:00
async def test_proxy_model_group_info_rerank ( prisma_client ) :
"""
Check if rerank model is returned on the following endpoints
` / v1 / models `
` / v1 / model / info `
` / v1 / model_group / info `
"""
import json
from fastapi import HTTPException , Request , Response
from starlette . datastructures import URL
from litellm . proxy . proxy_server import model_group_info , model_info_v1 , model_list
setattr ( litellm . proxy . proxy_server , " prisma_client " , prisma_client )
setattr ( litellm . proxy . proxy_server , " master_key " , " sk-1234 " )
await litellm . proxy . proxy_server . prisma_client . connect ( )
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
_model_list = [
{
" model_name " : " rerank-english-v3.0 " ,
" litellm_params " : { " model " : " cohere/rerank-english-v3.0 " } ,
" model_info " : {
" mode " : " rerank " ,
} ,
}
]
router = litellm . Router ( model_list = _model_list )
setattr ( litellm . proxy . proxy_server , " llm_router " , router )
setattr ( litellm . proxy . proxy_server , " llm_model_list " , _model_list )
request = Request ( scope = { " type " : " http " , " method " : " POST " , " headers " : { } } )
request . _url = URL ( url = " /v1/models " )
resp = await model_list (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
assert len ( resp [ " data " ] ) == 1
print ( resp )
resp = await model_info_v1 (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
models = resp [ " data " ]
assert models [ 0 ] [ " model_info " ] [ " mode " ] == " rerank "
resp = await model_group_info (
user_api_key_dict = UserAPIKeyAuth ( models = [ ] ) ,
)
print ( resp )
models = resp [ " data " ]
assert models [ 0 ] . mode == " rerank "
2024-10-17 13:16:23 +08:00
# @pytest.mark.asyncio
# async def test_proxy_team_member_add(prisma_client):
# """
# Add 10 people to a team. Confirm all 10 are added.
# """
# from litellm.proxy.management_endpoints.team_endpoints import (
# team_member_add,
# new_team,
# )
# from litellm.proxy._types import TeamMemberAddRequest, Member, NewTeamRequest
# setattr(litellm.proxy.proxy_server, "prisma_client", prisma_client)
# setattr(litellm.proxy.proxy_server, "master_key", "sk-1234")
# try:
# async def test():
# await litellm.proxy.proxy_server.prisma_client.connect()
# from litellm.proxy.proxy_server import user_api_key_cache
# user_api_key_dict = UserAPIKeyAuth(
# user_role=LitellmUserRoles.PROXY_ADMIN,
# api_key="sk-1234",
# user_id="1234",
# )
# new_team()
# for _ in range(10):
# request = TeamMemberAddRequest(
# team_id="1234",
# member=Member(
# user_id="1234",
# user_role=LitellmUserRoles.INTERNAL_USER,
# ),
# )
# key = await team_member_add(
# request, user_api_key_dict=user_api_key_dict
# )
# print(key)
# user_id = key.user_id
# # check /user/info to verify user_role was set correctly
# new_user_info = await user_info(
# user_id=user_id, user_api_key_dict=user_api_key_dict
# )
# new_user_info = new_user_info.user_info
# print("new_user_info=", new_user_info)
# assert new_user_info["user_role"] == LitellmUserRoles.INTERNAL_USER
# assert new_user_info["user_id"] == user_id
# generated_key = key.key
# bearer_token = "Bearer " + generated_key
# assert generated_key not in user_api_key_cache.in_memory_cache.cache_dict
# value_from_prisma = await prisma_client.get_data(
# token=generated_key,
# )
# print("token from prisma", value_from_prisma)
# request = Request(
# {
# "type": "http",
# "route": api_route,
# "path": api_route.path,
# "headers": [("Authorization", bearer_token)],
# }
# )
# # use generated key to auth in
# result = await user_api_key_auth(request=request, api_key=bearer_token)
# print("result from user auth with new key", result)
# asyncio.run(test())
# except Exception as e:
# pytest.fail(f"An exception occurred - {str(e)}")
2024-10-25 13:02:15 +08:00
@pytest.mark.asyncio
async def test_proxy_server_prisma_setup ( ) :
2024-12-13 10:43:17 +08:00
from litellm . proxy . proxy_server import ProxyStartupEvent , proxy_state
2024-10-25 13:02:15 +08:00
from litellm . proxy . utils import ProxyLogging
from litellm . caching import DualCache
user_api_key_cache = DualCache ( )
with patch . object (
litellm . proxy . proxy_server , " PrismaClient " , new = MagicMock ( )
) as mock_prisma_client :
mock_client = mock_prisma_client . return_value # This is the mocked instance
2024-11-05 03:13:32 +08:00
mock_client . connect = AsyncMock ( ) # Mock the connect method
2024-10-25 13:02:15 +08:00
mock_client . check_view_exists = AsyncMock ( ) # Mock the check_view_exists method
2024-11-07 09:36:48 +08:00
mock_client . health_check = AsyncMock ( ) # Mock the health_check method
2024-12-13 10:43:17 +08:00
mock_client . _set_spend_logs_row_count_in_proxy_state = (
AsyncMock ( )
) # Mock the _set_spend_logs_row_count_in_proxy_state method
2026-02-22 04:31:52 +08:00
mock_client . start_db_health_watchdog_task = AsyncMock ( )
2026-01-11 05:52:45 +08:00
# Mock the db attribute with start_token_refresh_task for RDS IAM token refresh
mock_db = MagicMock ( )
mock_db . start_token_refresh_task = AsyncMock ( )
mock_client . db = mock_db
2024-10-25 13:02:15 +08:00
2024-11-05 03:13:32 +08:00
await ProxyStartupEvent . _setup_prisma_client (
2024-10-25 13:02:15 +08:00
database_url = os . getenv ( " DATABASE_URL " ) ,
proxy_logging_obj = ProxyLogging ( user_api_key_cache = user_api_key_cache ) ,
user_api_key_cache = user_api_key_cache ,
)
2024-11-05 03:13:32 +08:00
# Verify our mocked methods were called
mock_client . connect . assert_called_once ( )
2024-10-25 13:02:15 +08:00
mock_client . check_view_exists . assert_called_once ( )
2024-11-07 09:36:48 +08:00
# Note: This is REALLY IMPORTANT to check that the health check is called
# This is how we ensure the DB is ready before proceeding
mock_client . health_check . assert_called_once ( )
2024-12-13 10:43:17 +08:00
# check that the spend logs row count is set in proxy state
mock_client . _set_spend_logs_row_count_in_proxy_state . assert_called_once ( )
assert proxy_state . get_proxy_state_variable ( " spend_logs_row_count " ) is not None
2024-11-07 09:36:48 +08:00
@pytest.mark.asyncio
async def test_proxy_server_prisma_setup_invalid_db ( ) :
"""
PROD TEST : Test that proxy server startup fails when it ' s unable to connect to the database
Think 2 - 3 times before editing / deleting this test , it ' s important for PROD
"""
from litellm . proxy . proxy_server import ProxyStartupEvent
from litellm . proxy . utils import ProxyLogging
from litellm . caching import DualCache
user_api_key_cache = DualCache ( )
invalid_db_url = " postgresql://invalid:invalid@localhost:5432/nonexistent "
_old_db_url = os . getenv ( " DATABASE_URL " )
os . environ [ " DATABASE_URL " ] = invalid_db_url
with pytest . raises ( Exception ) as exc_info :
await ProxyStartupEvent . _setup_prisma_client (
database_url = invalid_db_url ,
proxy_logging_obj = ProxyLogging ( user_api_key_cache = user_api_key_cache ) ,
user_api_key_cache = user_api_key_cache ,
)
print ( " GOT EXCEPTION= " , exc_info )
assert " httpx.ConnectError " in str ( exc_info . value )
# # Verify the error message indicates a database connection issue
# assert any(x in str(exc_info.value).lower() for x in ["database", "connection", "authentication"])
if _old_db_url :
os . environ [ " DATABASE_URL " ] = _old_db_url
2024-12-13 10:43:17 +08:00
@pytest.mark.asyncio
async def test_get_ui_settings_spend_logs_threshold ( ) :
"""
Test that get_ui_settings correctly sets DISABLE_EXPENSIVE_DB_QUERIES based on spend_logs_row_count threshold
"""
from litellm . proxy . management_endpoints . ui_sso import get_ui_settings
from litellm . proxy . proxy_server import proxy_state
from fastapi import Request
from litellm . constants import MAX_SPENDLOG_ROWS_TO_QUERY
# Create a mock request
mock_request = Request (
scope = {
" type " : " http " ,
" headers " : [ ] ,
" method " : " GET " ,
" scheme " : " http " ,
" server " : ( " testserver " , 80 ) ,
" path " : " /sso/get/ui_settings " ,
" query_string " : b " " ,
}
)
# Test case 1: When spend_logs_row_count > MAX_SPENDLOG_ROWS_TO_QUERY
proxy_state . set_proxy_state_variable (
" spend_logs_row_count " , MAX_SPENDLOG_ROWS_TO_QUERY + 1
)
response = await get_ui_settings ( mock_request )
print ( " response from get_ui_settings " , json . dumps ( response , indent = 4 ) )
assert response [ " DISABLE_EXPENSIVE_DB_QUERIES " ] is True
assert response [ " NUM_SPEND_LOGS_ROWS " ] == MAX_SPENDLOG_ROWS_TO_QUERY + 1
# Test case 2: When spend_logs_row_count < MAX_SPENDLOG_ROWS_TO_QUERY
proxy_state . set_proxy_state_variable (
" spend_logs_row_count " , MAX_SPENDLOG_ROWS_TO_QUERY - 1
)
response = await get_ui_settings ( mock_request )
print ( " response from get_ui_settings " , json . dumps ( response , indent = 4 ) )
assert response [ " DISABLE_EXPENSIVE_DB_QUERIES " ] is False
assert response [ " NUM_SPEND_LOGS_ROWS " ] == MAX_SPENDLOG_ROWS_TO_QUERY - 1
# Test case 3: Edge case - exactly MAX_SPENDLOG_ROWS_TO_QUERY
proxy_state . set_proxy_state_variable (
" spend_logs_row_count " , MAX_SPENDLOG_ROWS_TO_QUERY
)
response = await get_ui_settings ( mock_request )
print ( " response from get_ui_settings " , json . dumps ( response , indent = 4 ) )
assert response [ " DISABLE_EXPENSIVE_DB_QUERIES " ] is False
assert response [ " NUM_SPEND_LOGS_ROWS " ] == MAX_SPENDLOG_ROWS_TO_QUERY
# Clean up
proxy_state . set_proxy_state_variable ( " spend_logs_row_count " , 0 )
2025-01-29 10:01:27 +08:00
2025-05-24 11:52:35 +08:00
@pytest.mark.asyncio
async def test_run_background_health_check_reflects_llm_model_list ( monkeypatch ) :
"""
Test that _run_background_health_check reflects changes to llm_model_list in each health check iteration .
"""
import litellm . proxy . proxy_server as proxy_server
import copy
test_model_list_1 = [ { " model_name " : " model-a " } ]
test_model_list_2 = [ { " model_name " : " model-b " } ]
called_model_lists = [ ]
2026-03-29 10:17:38 +08:00
async def fake_perform_health_check ( model_list , details , max_concurrency = None ) :
2025-05-24 11:52:35 +08:00
called_model_lists . append ( copy . deepcopy ( model_list ) )
Litellm ishaan april4 2 (#25150)
* feat(router): integrate allowed_fails_policy into health check failures (#24988)
* feat(router): integrate allowed_fails_policy into health check failures
Health check failures now increment the same per-deployment failure
counters used by allowed_fails_policy, so users can control how many
health check failures of each error type are required before a
deployment enters cooldown.
- ahealth_check() preserves the original exception in its return dict
- run_with_timeout() returns a litellm.Timeout on health check timeout
- _perform_health_check() propagates exceptions to unhealthy endpoints
- _write_health_state_to_router_cache() calls _set_cooldown_deployments
for each unhealthy endpoint that has an exception
- When allowed_fails_policy is set, the binary health check filter is
bypassed so cooldown is the sole routing exclusion mechanism
- Safety net: if all deployments are in cooldown with
enable_health_check_routing=True, the cooldown filter is bypassed
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat(router): add health_check_ignore_transient_errors flag
When enabled, health check failures with 429 (rate limit) or 408 (timeout)
status codes are skipped from the cooldown pipeline. These are transient
load issues, not broken deployments. Auth errors (401), 404, and 5xx errors
still increment counters and trigger cooldown as before.
Config (general_settings):
health_check_ignore_transient_errors: true
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(router): also exclude 429/408 from health state cache when ignore_transient_errors set
The previous fix only skipped cooldown counter increments. The health state
cache was still marking 429/408 endpoints as is_healthy=False, causing the
binary health check filter to exclude them from routing.
Now, when health_check_ignore_transient_errors=True, 429/408 endpoints are
also excluded from the unhealthy list passed to build_deployment_health_states(),
so the binary filter treats them as unaffected (not unhealthy).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* docs(router): add health check driven routing guide
New standalone page covering the full health check routing feature:
allowed_fails_policy integration, health_check_ignore_transient_errors,
architecture SVG, step-by-step setup, and gotchas (TTL, AllowedFails semantics).
Replaces the inline section in health.md with a link to the new page.
Added to the Routing & Load Balancing sidebar.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): fix three CI failures
- Add "exception" to ILLEGAL_DISPLAY_PARAMS in health_check.py so the
exception object is stripped before the health endpoint serializes
results to JSON (fixes TypeError: 'URL' object is not iterable)
- Add allowed_fails_policy = None to FakeRouter stubs in
test_router_health_check_routing.py (fixes AttributeError)
- Add health_check_ignore_transient_errors to config_settings.md router
settings reference table (fixes documentation test)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Fix litellm/tests/proxy_unit_tests/test_proxy_server.py
* fix(router): address greptile review comments
- Narrow cooldown safety-net bypass: only fires when allowed_fails_policy
is set (cooldown is health-check driven). Without a policy, cooldowns
are from real request failures and must not be bypassed.
- Restore cooldown deployments DEBUG log that was accidentally removed.
- Fix test_health TypeError: move exception extraction to a separate
exceptions_by_model_id dict returned alongside endpoints, so exception
objects never appear in the endpoint dicts that get JSON-serialized
by the /health response.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): properly isolate exceptions from health response
Return exceptions_by_model_id as a separate third value from
_perform_health_check / perform_health_check so exception objects
(which contain non-JSON-serializable httpx URL types) never appear
in the endpoint dicts that get serialized by the /health response.
Callers updated: _health_endpoints.py, shared_health_check_manager.py,
proxy_server.py background loop. All use the exceptions dict only for
cooldown integration, not for display.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(shared-health-check): fix remaining 2-value return sites and update type annotation
* fix(health-check-routing): fix P0 cooldown integration never firing
The cooldown loop was reading endpoint.get("exception") which is always
None because exceptions are now returned via exceptions_by_model_id, not
stored in endpoint dicts. Fixed to use _exceptions.get(model_id).
Also fixes the transient-error filter to use _exceptions instead of
endpoint.get("exception"), and fixes all remaining 2-value return sites
in shared_health_check_manager.py. Tests updated to pass exceptions via
exceptions_by_model_id parameter instead of endpoint dicts.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): fix P1 transient-error filter broken on cache hits
When SharedHealthCheckManager returns cached results, exceptions_by_model_id
is always {} so the transient-error filter defaulted to status 500 for all
endpoints, incorrectly marking 429/408 endpoints as unhealthy.
Fix: store integer exception_status on each unhealthy endpoint dict in
_perform_health_check. _get_endpoint_exception_status() uses the live
exception object when available (direct path) and falls back to the stored
integer (cache-hit path). The integer is JSON-serializable and survives
the shared cache round-trip.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): gate cooldown loop behind allowed_fails_policy
Without the policy, cooldown is not the routing exclusion mechanism.
Firing _set_cooldown_deployments for all enable_health_check_routing users
was a backwards-incompatible change — 401s would immediately cooldown
deployments that the binary filter would have recovered on the next cycle.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* revert: undo allowed_fails_policy gate on cooldown loop
Cooldown integration via health checks is intentional for all
enable_health_check_routing users, not just those with allowed_fails_policy.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(docs+tests): fix health_check_ignore_transient_errors doc section and test coverage
- Move health_check_ignore_transient_errors from router_settings to
general_settings in config_settings.md (code reads it from general_settings)
- Remove duplicate enable_health_check_routing / health_check_staleness_threshold
entries that were incorrectly listed under router_settings
- Replace TestHealthCheckEndpointExceptionPropagation tests with ones that
exercise the real _perform_health_check code path via mocked ahealth_check,
verifying exceptions appear in exceptions_by_model_id and NOT in endpoint dicts
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(tests+docs): fix tuple unpacking and docs test failures
- Update test mocks that return (healthy, unhealthy) to return
(healthy, unhealthy, {}) to match the new 3-value signature
- Update test unpackings of perform_shared_health_check to use
healthy, unhealthy, _ = ...
- Add health_check_ignore_transient_errors to router_settings section
in config_settings.md (it is a Router constructor param, so the doc
test requires it there; it also lives in general_settings for proxy use)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Fix CodeQL errors
* fix(tests): fix 2-value unpackings of _perform_health_check in test_health_check.py
* fix(tests): fix mock _perform_health_check returning 2-tuple instead of 3
* fix team routing
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: add distributed lock for key rotation job (#23364)
* fix: add distributed lock for key rotation job
* fix: address Greptile review feedback on key rotation lock (#23834)
* fix: address Greptile review feedback on key rotation lock
* fix req changes greptile
* feat(proxy): Optional on_error for guardrail pipeline (API / technical failures) (#24831)
* guardrails fallback
* docs
* docs: add LITELLM_KEY_ROTATION_LOCK_TTL_SECONDS to environment variables reference
* fix(mypy): accept Union[Dict, Any] in _get_deployment_order and use typed list to fix min() type error
* fix(mypy): use Optional[str] for api_base in PydanticAI provider to match superclass signature
---------
Co-authored-by: Sameer Kankute <sameer@berri.ai>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Harshit Jain <48647625+Harshit28j@users.noreply.github.com>
Co-authored-by: Shivam Rawat <shivam@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
2026-04-05 07:09:42 +08:00
return ( [ " healthy " ] , [ " unhealthy " ] , { } )
2025-05-24 11:52:35 +08:00
monkeypatch . setattr ( proxy_server , " health_check_interval " , 1 )
monkeypatch . setattr ( proxy_server , " health_check_details " , None )
2025-06-21 14:11:53 +08:00
monkeypatch . setattr (
proxy_server , " llm_model_list " , copy . deepcopy ( test_model_list_1 )
)
2025-05-24 11:52:35 +08:00
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
monkeypatch . setattr ( proxy_server , " health_check_results " , { } )
async def fake_sleep ( interval ) :
raise asyncio . CancelledError ( )
monkeypatch . setattr ( asyncio , " sleep " , fake_sleep )
try :
await proxy_server . _run_background_health_check ( )
except asyncio . CancelledError :
pass
2025-06-21 14:11:53 +08:00
monkeypatch . setattr (
proxy_server , " llm_model_list " , copy . deepcopy ( test_model_list_2 )
)
2025-05-24 11:52:35 +08:00
try :
await proxy_server . _run_background_health_check ( )
except asyncio . CancelledError :
pass
assert len ( called_model_lists ) > = 2
assert called_model_lists [ 0 ] == test_model_list_1
assert called_model_lists [ 1 ] == test_model_list_2
2025-08-01 04:48:35 +08:00
@pytest.mark.asyncio
async def test_background_health_check_skip_disabled_models ( monkeypatch ) :
""" Ensure models with disable_background_health_check are skipped. """
import litellm . proxy . proxy_server as proxy_server
import copy
test_model_list = [
{ " model_name " : " model-a " } ,
2026-03-29 10:17:38 +08:00
{
" model_name " : " model-b " ,
" model_info " : { " disable_background_health_check " : True } ,
} ,
2025-08-01 04:48:35 +08:00
]
called_model_lists = [ ]
2026-05-14 00:49:05 +08:00
async def fake_perform_health_check (
model_list , details , max_concurrency = None , * * kwargs
) :
2025-08-01 04:48:35 +08:00
called_model_lists . append ( copy . deepcopy ( model_list ) )
Litellm ishaan april4 2 (#25150)
* feat(router): integrate allowed_fails_policy into health check failures (#24988)
* feat(router): integrate allowed_fails_policy into health check failures
Health check failures now increment the same per-deployment failure
counters used by allowed_fails_policy, so users can control how many
health check failures of each error type are required before a
deployment enters cooldown.
- ahealth_check() preserves the original exception in its return dict
- run_with_timeout() returns a litellm.Timeout on health check timeout
- _perform_health_check() propagates exceptions to unhealthy endpoints
- _write_health_state_to_router_cache() calls _set_cooldown_deployments
for each unhealthy endpoint that has an exception
- When allowed_fails_policy is set, the binary health check filter is
bypassed so cooldown is the sole routing exclusion mechanism
- Safety net: if all deployments are in cooldown with
enable_health_check_routing=True, the cooldown filter is bypassed
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat(router): add health_check_ignore_transient_errors flag
When enabled, health check failures with 429 (rate limit) or 408 (timeout)
status codes are skipped from the cooldown pipeline. These are transient
load issues, not broken deployments. Auth errors (401), 404, and 5xx errors
still increment counters and trigger cooldown as before.
Config (general_settings):
health_check_ignore_transient_errors: true
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(router): also exclude 429/408 from health state cache when ignore_transient_errors set
The previous fix only skipped cooldown counter increments. The health state
cache was still marking 429/408 endpoints as is_healthy=False, causing the
binary health check filter to exclude them from routing.
Now, when health_check_ignore_transient_errors=True, 429/408 endpoints are
also excluded from the unhealthy list passed to build_deployment_health_states(),
so the binary filter treats them as unaffected (not unhealthy).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* docs(router): add health check driven routing guide
New standalone page covering the full health check routing feature:
allowed_fails_policy integration, health_check_ignore_transient_errors,
architecture SVG, step-by-step setup, and gotchas (TTL, AllowedFails semantics).
Replaces the inline section in health.md with a link to the new page.
Added to the Routing & Load Balancing sidebar.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): fix three CI failures
- Add "exception" to ILLEGAL_DISPLAY_PARAMS in health_check.py so the
exception object is stripped before the health endpoint serializes
results to JSON (fixes TypeError: 'URL' object is not iterable)
- Add allowed_fails_policy = None to FakeRouter stubs in
test_router_health_check_routing.py (fixes AttributeError)
- Add health_check_ignore_transient_errors to config_settings.md router
settings reference table (fixes documentation test)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Fix litellm/tests/proxy_unit_tests/test_proxy_server.py
* fix(router): address greptile review comments
- Narrow cooldown safety-net bypass: only fires when allowed_fails_policy
is set (cooldown is health-check driven). Without a policy, cooldowns
are from real request failures and must not be bypassed.
- Restore cooldown deployments DEBUG log that was accidentally removed.
- Fix test_health TypeError: move exception extraction to a separate
exceptions_by_model_id dict returned alongside endpoints, so exception
objects never appear in the endpoint dicts that get JSON-serialized
by the /health response.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): properly isolate exceptions from health response
Return exceptions_by_model_id as a separate third value from
_perform_health_check / perform_health_check so exception objects
(which contain non-JSON-serializable httpx URL types) never appear
in the endpoint dicts that get serialized by the /health response.
Callers updated: _health_endpoints.py, shared_health_check_manager.py,
proxy_server.py background loop. All use the exceptions dict only for
cooldown integration, not for display.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(shared-health-check): fix remaining 2-value return sites and update type annotation
* fix(health-check-routing): fix P0 cooldown integration never firing
The cooldown loop was reading endpoint.get("exception") which is always
None because exceptions are now returned via exceptions_by_model_id, not
stored in endpoint dicts. Fixed to use _exceptions.get(model_id).
Also fixes the transient-error filter to use _exceptions instead of
endpoint.get("exception"), and fixes all remaining 2-value return sites
in shared_health_check_manager.py. Tests updated to pass exceptions via
exceptions_by_model_id parameter instead of endpoint dicts.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): fix P1 transient-error filter broken on cache hits
When SharedHealthCheckManager returns cached results, exceptions_by_model_id
is always {} so the transient-error filter defaulted to status 500 for all
endpoints, incorrectly marking 429/408 endpoints as unhealthy.
Fix: store integer exception_status on each unhealthy endpoint dict in
_perform_health_check. _get_endpoint_exception_status() uses the live
exception object when available (direct path) and falls back to the stored
integer (cache-hit path). The integer is JSON-serializable and survives
the shared cache round-trip.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(health-check-routing): gate cooldown loop behind allowed_fails_policy
Without the policy, cooldown is not the routing exclusion mechanism.
Firing _set_cooldown_deployments for all enable_health_check_routing users
was a backwards-incompatible change — 401s would immediately cooldown
deployments that the binary filter would have recovered on the next cycle.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* revert: undo allowed_fails_policy gate on cooldown loop
Cooldown integration via health checks is intentional for all
enable_health_check_routing users, not just those with allowed_fails_policy.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(docs+tests): fix health_check_ignore_transient_errors doc section and test coverage
- Move health_check_ignore_transient_errors from router_settings to
general_settings in config_settings.md (code reads it from general_settings)
- Remove duplicate enable_health_check_routing / health_check_staleness_threshold
entries that were incorrectly listed under router_settings
- Replace TestHealthCheckEndpointExceptionPropagation tests with ones that
exercise the real _perform_health_check code path via mocked ahealth_check,
verifying exceptions appear in exceptions_by_model_id and NOT in endpoint dicts
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix(tests+docs): fix tuple unpacking and docs test failures
- Update test mocks that return (healthy, unhealthy) to return
(healthy, unhealthy, {}) to match the new 3-value signature
- Update test unpackings of perform_shared_health_check to use
healthy, unhealthy, _ = ...
- Add health_check_ignore_transient_errors to router_settings section
in config_settings.md (it is a Router constructor param, so the doc
test requires it there; it also lives in general_settings for proxy use)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Fix CodeQL errors
* fix(tests): fix 2-value unpackings of _perform_health_check in test_health_check.py
* fix(tests): fix mock _perform_health_check returning 2-tuple instead of 3
* fix team routing
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: add distributed lock for key rotation job (#23364)
* fix: add distributed lock for key rotation job
* fix: address Greptile review feedback on key rotation lock (#23834)
* fix: address Greptile review feedback on key rotation lock
* fix req changes greptile
* feat(proxy): Optional on_error for guardrail pipeline (API / technical failures) (#24831)
* guardrails fallback
* docs
* docs: add LITELLM_KEY_ROTATION_LOCK_TTL_SECONDS to environment variables reference
* fix(mypy): accept Union[Dict, Any] in _get_deployment_order and use typed list to fix min() type error
* fix(mypy): use Optional[str] for api_base in PydanticAI provider to match superclass signature
---------
Co-authored-by: Sameer Kankute <sameer@berri.ai>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Harshit Jain <48647625+Harshit28j@users.noreply.github.com>
Co-authored-by: Shivam Rawat <shivam@berri.ai>
Co-authored-by: yuneng-jiang <yuneng@berri.ai>
2026-04-05 07:09:42 +08:00
return ( [ " healthy " ] , [ ] , { } )
2025-08-01 04:48:35 +08:00
monkeypatch . setattr ( proxy_server , " health_check_interval " , 1 )
monkeypatch . setattr ( proxy_server , " health_check_details " , None )
monkeypatch . setattr ( proxy_server , " llm_model_list " , copy . deepcopy ( test_model_list ) )
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
monkeypatch . setattr ( proxy_server , " health_check_results " , { } )
async def fake_sleep ( interval ) :
raise asyncio . CancelledError ( )
monkeypatch . setattr ( asyncio , " sleep " , fake_sleep )
try :
await proxy_server . _run_background_health_check ( )
except asyncio . CancelledError :
pass
assert called_model_lists == [ [ { " model_name " : " model-a " } ] ]
2026-05-14 00:49:05 +08:00
@pytest.mark.asyncio
async def test_run_direct_health_check_with_instrumentation_legacy_three_arg_stub (
monkeypatch ,
) :
""" Monkeypatched perform_health_check with only base kwargs should still run. """
import litellm . proxy . proxy_server as proxy_server
async def fake_perform_health_check ( model_list , details , max_concurrency = None ) :
return ( [ ] , [ ] , { } )
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
result = await proxy_server . _run_direct_health_check_with_instrumentation (
[ { " model_name " : " m " } ] ,
True ,
1 ,
{ " enabled " : True , " source " : " test " , " cycle_id " : " c1 " } ,
)
assert result == ( [ ] , [ ] , { } )
@pytest.mark.asyncio
async def test_run_direct_health_check_with_instrumentation_accepts_instrumentation_only (
monkeypatch ,
) :
""" Stub that accepts instrumentation_context but not health_check filter kwargs. """
import litellm . proxy . proxy_server as proxy_server
seen : list = [ ]
async def fake_perform_health_check (
model_list , details , max_concurrency = None , instrumentation_context = None
) :
seen . append ( instrumentation_context )
return ( [ ] , [ ] , { } )
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
await proxy_server . _run_direct_health_check_with_instrumentation (
[ ] ,
False ,
2 ,
{ " enabled " : True , " source " : " test " , " cycle_id " : " c2 " } ,
)
assert len ( seen ) == 1
assert seen [ 0 ] [ " cycle_id " ] == " c2 "
@pytest.mark.asyncio
async def test_run_direct_health_check_with_instrumentation_accepts_filter_only (
monkeypatch ,
) :
""" Stub that accepts health_check_skip_disabled_background_models but not instrumentation. """
import litellm . proxy . proxy_server as proxy_server
seen : list = [ ]
async def fake_perform_health_check (
model_list ,
details ,
max_concurrency = None ,
health_check_skip_disabled_background_models = False ,
) :
seen . append ( health_check_skip_disabled_background_models )
return ( [ ] , [ ] , { } )
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
await proxy_server . _run_direct_health_check_with_instrumentation (
[ ] ,
True ,
None ,
{ " enabled " : False } ,
)
assert len ( seen ) == 1
assert seen [ 0 ] is False
@pytest.mark.asyncio
async def test_run_direct_health_check_with_instrumentation_non_kw_typeerror_reraises (
monkeypatch ,
) :
import litellm . proxy . proxy_server as proxy_server
async def fake_perform_health_check ( * * kwargs ) :
raise TypeError ( " unsupported operand type(s) " )
monkeypatch . setattr ( proxy_server , " perform_health_check " , fake_perform_health_check )
with pytest . raises ( TypeError , match = " unsupported operand " ) :
await proxy_server . _run_direct_health_check_with_instrumentation (
[ ] ,
True ,
1 ,
{ } ,
)
2025-01-29 10:01:27 +08:00
def test_get_timeout_from_request ( ) :
from litellm . proxy . litellm_pre_call_utils import LiteLLMProxyRequestSetup
headers = {
" x-litellm-timeout " : " 90 " ,
}
timeout = LiteLLMProxyRequestSetup . _get_timeout_from_request ( headers )
assert timeout == 90
headers = {
" x-litellm-timeout " : " 90.5 " ,
}
timeout = LiteLLMProxyRequestSetup . _get_timeout_from_request ( headers )
assert timeout == 90.5
2025-11-06 10:30:20 +08:00
@pytest.mark.parametrize (
" ui_exists, ui_has_content " ,
[
2026-03-29 10:17:38 +08:00
( True , True ) , # UI path exists and has content
2025-11-06 10:30:20 +08:00
( True , False ) , # UI path exists but is empty
2026-03-29 10:17:38 +08:00
( False , False ) , # UI path doesn't exist
2025-11-06 10:30:20 +08:00
] ,
)
def test_non_root_ui_path_logic ( monkeypatch , tmp_path , ui_exists , ui_has_content ) :
"""
Test the non - root Docker UI path detection logic .
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
Tests that when LITELLM_NON_ROOT is set to " true " :
- If UI path exists and has content , it should be used
- If UI path doesn ' t exist or is empty, proper error logging occurs
"""
import tempfile
import shutil
from unittest . mock import MagicMock
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
# Create a temporary directory to act as /tmp/litellm_ui
test_ui_path = tmp_path / " litellm_ui "
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
if ui_exists :
test_ui_path . mkdir ( parents = True , exist_ok = True )
if ui_has_content :
# Create some dummy files to simulate built UI
( test_ui_path / " index.html " ) . write_text ( " <html></html> " )
( test_ui_path / " app.js " ) . write_text ( " console.log( ' test ' ); " )
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
# Mock the environment variable and os.path operations
monkeypatch . setenv ( " LITELLM_NON_ROOT " , " true " )
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
# Create a mock logger to capture log messages
mock_logger = MagicMock ( )
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
# We need to reimport or reload the relevant code section
# Since this is module-level code, we'll test the logic directly
ui_path = None
non_root_ui_path = str ( test_ui_path )
2026-03-29 10:17:38 +08:00
2025-11-06 10:30:20 +08:00
# Simulate the logic from proxy_server.py lines 909-920
if os . getenv ( " LITELLM_NON_ROOT " , " " ) . lower ( ) == " true " :
if os . path . exists ( non_root_ui_path ) and os . listdir ( non_root_ui_path ) :
2026-03-29 10:17:38 +08:00
mock_logger . info (
f " Using pre-built UI for non-root Docker: { non_root_ui_path } "
)
mock_logger . info (
f " UI files found: { len ( os . listdir ( non_root_ui_path ) ) } items "
)
2025-11-06 10:30:20 +08:00
ui_path = non_root_ui_path
else :
2026-03-29 10:17:38 +08:00
mock_logger . error (
f " UI not found at { non_root_ui_path } . UI will not be available. "
)
mock_logger . error (
f " Path exists: { os . path . exists ( non_root_ui_path ) } , Has content: { os . path . exists ( non_root_ui_path ) and bool ( os . listdir ( non_root_ui_path ) ) } "
)
2025-11-06 10:30:20 +08:00
# Verify behavior based on test parameters
if ui_exists and ui_has_content :
# UI should be found and used
assert ui_path == non_root_ui_path
assert mock_logger . info . call_count == 2
2026-03-29 10:17:38 +08:00
mock_logger . info . assert_any_call (
f " Using pre-built UI for non-root Docker: { non_root_ui_path } "
)
2025-11-06 10:30:20 +08:00
# Verify the second info call mentions the number of items
info_calls = [ call [ 0 ] [ 0 ] for call in mock_logger . info . call_args_list ]
assert any ( " UI files found: " in call and " items " in call for call in info_calls )
assert mock_logger . error . call_count == 0
else :
# UI should not be found, error should be logged
assert ui_path is None
assert mock_logger . error . call_count == 2
2026-03-29 10:17:38 +08:00
mock_logger . error . assert_any_call (
f " UI not found at { non_root_ui_path } . UI will not be available. "
)
2025-11-06 10:30:20 +08:00
# Verify the second error call has path existence info
error_calls = [ call [ 0 ] [ 0 ] for call in mock_logger . error . call_args_list ]
assert any ( " Path exists: " in call for call in error_calls )
assert mock_logger . info . call_count == 0
2025-11-07 04:38:47 +08:00
@pytest.mark.asyncio
async def test_get_config_callbacks_with_all_types ( client_no_auth ) :
"""
Test that / get / config / callbacks returns all three callback types :
- success_callback with type = " success "
2026-03-29 10:17:38 +08:00
- failure_callback with type = " failure "
2025-11-11 09:28:13 +08:00
- callbacks ( success_and_failure ) with type = " success_and_failure "
2025-11-07 04:38:47 +08:00
"""
from litellm . proxy . proxy_server import ProxyConfig
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Create a mock config with all three callback types
mock_config_data = {
" litellm_settings " : {
" success_callback " : [ " langfuse " , " braintrust " ] ,
" failure_callback " : [ " sentry " ] ,
2026-03-29 10:17:38 +08:00
" callbacks " : [ " otel " , " langsmith " ] ,
2025-11-07 04:38:47 +08:00
} ,
" environment_variables " : {
" LANGFUSE_PUBLIC_KEY " : " test-public-key " ,
" LANGFUSE_SECRET_KEY " : " test-secret-key " ,
" LANGFUSE_HOST " : " https://test.langfuse.com " ,
" BRAINTRUST_API_KEY " : " test-braintrust-key " ,
" OTEL_EXPORTER " : " otlp " ,
" OTEL_ENDPOINT " : " http://localhost:4317 " ,
" LANGSMITH_API_KEY " : " test-langsmith-key " ,
} ,
2026-03-29 10:17:38 +08:00
" general_settings " : { } ,
2025-11-07 04:38:47 +08:00
}
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
with patch . object (
proxy_config , " get_config " , new = AsyncMock ( return_value = mock_config_data )
) :
response = client_no_auth . get ( " /get/config/callbacks " )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
assert response . status_code == 200
result = response . json ( )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Verify response structure
assert " status " in result
assert result [ " status " ] == " success "
assert " callbacks " in result
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
callbacks = result [ " callbacks " ]
2026-03-29 10:17:38 +08:00
2025-11-11 09:28:13 +08:00
# Verify we have all 5 callbacks (2 success + 1 failure + 2 success_and_failure)
2025-11-07 04:38:47 +08:00
assert len ( callbacks ) == 5
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Group callbacks by type
success_callbacks = [ cb for cb in callbacks if cb . get ( " type " ) == " success " ]
failure_callbacks = [ cb for cb in callbacks if cb . get ( " type " ) == " failure " ]
2026-03-29 10:17:38 +08:00
success_and_failure_callbacks = [
cb for cb in callbacks if cb . get ( " type " ) == " success_and_failure "
]
2025-11-07 04:38:47 +08:00
# Verify all callbacks have required fields
for callback in callbacks :
assert " name " in callback
assert " variables " in callback
assert " type " in callback
2025-11-11 09:28:13 +08:00
assert callback [ " type " ] in [ " success " , " failure " , " success_and_failure " ]
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Verify success callbacks
assert len ( success_callbacks ) == 2
success_names = [ cb [ " name " ] for cb in success_callbacks ]
assert " langfuse " in success_names
assert " braintrust " in success_names
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Verify failure callbacks
assert len ( failure_callbacks ) == 1
assert failure_callbacks [ 0 ] [ " name " ] == " sentry "
2026-03-29 10:17:38 +08:00
2025-11-11 09:28:13 +08:00
# Verify success_and_failure callbacks
assert len ( success_and_failure_callbacks ) == 2
success_and_failure_names = [ cb [ " name " ] for cb in success_and_failure_callbacks ]
assert " otel " in success_and_failure_names
assert " langsmith " in success_and_failure_names
2025-11-07 04:38:47 +08:00
@pytest.mark.asyncio
async def test_get_config_callbacks_environment_variables ( client_no_auth ) :
"""
Test that / get / config / callbacks correctly includes environment variables
2025-12-07 13:23:49 +08:00
for each callback type . Values are returned as - is from the config ( no decryption ) .
2025-11-07 04:38:47 +08:00
"""
from litellm . proxy . proxy_server import ProxyConfig
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Create a mock config with callbacks and their env vars
mock_config_data = {
" litellm_settings " : {
" success_callback " : [ " langfuse " ] ,
" failure_callback " : [ ] ,
2026-03-29 10:17:38 +08:00
" callbacks " : [ " otel " ] ,
2025-11-07 04:38:47 +08:00
} ,
" environment_variables " : {
2025-12-07 13:23:49 +08:00
" LANGFUSE_PUBLIC_KEY " : " test-public-key " ,
" LANGFUSE_SECRET_KEY " : " test-secret-key " ,
2025-11-07 04:38:47 +08:00
" LANGFUSE_HOST " : " https://cloud.langfuse.com " ,
" OTEL_EXPORTER " : " otlp " ,
" OTEL_ENDPOINT " : " http://localhost:4317 " ,
" OTEL_HEADERS " : " key=value " ,
} ,
2026-03-29 10:17:38 +08:00
" general_settings " : { } ,
2025-11-07 04:38:47 +08:00
}
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
proxy_config = getattr ( litellm . proxy . proxy_server , " proxy_config " )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
with patch . object (
proxy_config , " get_config " , new = AsyncMock ( return_value = mock_config_data )
) :
response = client_no_auth . get ( " /get/config/callbacks " )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
assert response . status_code == 200
result = response . json ( )
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
callbacks = result [ " callbacks " ]
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Find langfuse callback (success type)
langfuse_callback = next (
( cb for cb in callbacks if cb [ " name " ] == " langfuse " ) , None
)
assert langfuse_callback is not None
assert langfuse_callback [ " type " ] == " success "
assert " variables " in langfuse_callback
2026-03-29 10:17:38 +08:00
2025-12-07 13:23:49 +08:00
# Verify langfuse env vars are present (values returned as-is, no decryption)
2025-11-07 04:38:47 +08:00
langfuse_vars = langfuse_callback [ " variables " ]
assert " LANGFUSE_PUBLIC_KEY " in langfuse_vars
2025-12-07 13:23:49 +08:00
assert langfuse_vars [ " LANGFUSE_PUBLIC_KEY " ] == " test-public-key "
2025-11-07 04:38:47 +08:00
assert " LANGFUSE_SECRET_KEY " in langfuse_vars
2025-12-07 13:23:49 +08:00
assert langfuse_vars [ " LANGFUSE_SECRET_KEY " ] == " test-secret-key "
2025-11-07 04:38:47 +08:00
assert " LANGFUSE_HOST " in langfuse_vars
assert langfuse_vars [ " LANGFUSE_HOST " ] == " https://cloud.langfuse.com "
2026-03-29 10:17:38 +08:00
2025-11-11 09:28:13 +08:00
# Find otel callback (success_and_failure type)
2026-03-29 10:17:38 +08:00
otel_callback = next ( ( cb for cb in callbacks if cb [ " name " ] == " otel " ) , None )
2025-11-07 04:38:47 +08:00
assert otel_callback is not None
2025-11-11 09:28:13 +08:00
assert otel_callback [ " type " ] == " success_and_failure "
2025-11-07 04:38:47 +08:00
assert " variables " in otel_callback
2026-03-29 10:17:38 +08:00
2025-11-07 04:38:47 +08:00
# Verify otel env vars are present
otel_vars = otel_callback [ " variables " ]
assert " OTEL_EXPORTER " in otel_vars
assert otel_vars [ " OTEL_EXPORTER " ] == " otlp "
assert " OTEL_ENDPOINT " in otel_vars
assert otel_vars [ " OTEL_ENDPOINT " ] == " http://localhost:4317 "
assert " OTEL_HEADERS " in otel_vars
assert otel_vars [ " OTEL_HEADERS " ] == " key=value "
2025-11-15 12:02:35 +08:00
2025-11-13 10:43:37 +08:00
@pytest.mark.asyncio
async def test_update_config_success_callback_normalization ( ) :
"""
Ensure success_callback values are normalized to lowercase when updating config .
This prevents delete_callback ( which searches lowercase ) from failing on mixed case inputs like ' SQS ' .
"""
import litellm . proxy . proxy_server as proxy_server
from litellm . proxy . _types import ConfigYAML
setattr ( proxy_server , " proxy_logging_obj " , MagicMock ( ) )
2026-04-28 05:50:59 +08:00
existing_litellm_settings = { " success_callback " : [ " langfuse " ] }
class FakeRow :
def __init__ ( self , name , value ) :
self . param_name = name
self . param_value = value
upserted = { }
async def fake_find_first ( where = None ) :
if where and where . get ( " param_name " ) == " litellm_settings " :
return FakeRow ( " litellm_settings " , existing_litellm_settings )
return None
async def fake_upsert ( where = None , data = None ) :
upserted [ where [ " param_name " ] ] = json . loads ( data [ " update " ] [ " param_value " ] )
2025-11-13 10:43:37 +08:00
class MockPrisma :
def __init__ ( self ) :
self . db = MagicMock ( )
self . db . litellm_config = MagicMock ( )
2026-04-28 05:50:59 +08:00
self . db . litellm_config . find_first = AsyncMock ( side_effect = fake_find_first )
self . db . litellm_config . upsert = AsyncMock ( side_effect = fake_upsert )
2025-11-13 10:43:37 +08:00
setattr ( proxy_server , " prisma_client " , MockPrisma ( ) )
class MockProxyConfig :
async def add_deployment ( self , prisma_client = None , proxy_logging_obj = None ) :
return None
2026-04-28 05:50:59 +08:00
setattr ( proxy_server , " proxy_config " , MockProxyConfig ( ) )
2025-11-13 10:43:37 +08:00
config_update = ConfigYAML ( litellm_settings = { " success_callback " : [ " SQS " , " sQs " ] } )
2026-03-31 09:55:01 +08:00
from litellm . proxy . _types import LitellmUserRoles , UserAPIKeyAuth
2026-04-18 04:02:59 +08:00
admin_user = UserAPIKeyAuth (
user_role = LitellmUserRoles . PROXY_ADMIN , api_key = " sk-test "
)
2026-03-31 09:55:01 +08:00
await proxy_server . update_config ( config_update , user_api_key_dict = admin_user )
2025-11-13 10:43:37 +08:00
2026-04-28 05:50:59 +08:00
assert (
" litellm_settings " in upserted
) , " litellm_config.upsert was not called for litellm_settings "
callbacks = upserted [ " litellm_settings " ] [ " success_callback " ]
2025-11-13 10:43:37 +08:00
# Deduped and normalized
assert " sqs " in callbacks
assert " SQS " not in callbacks
assert " sQs " not in callbacks
# Existing callback should still be present
assert " langfuse " in callbacks
2025-12-17 06:24:12 +08:00
@pytest.mark.parametrize (
" data " ,
[
{
" model " : {
" model_name " : " azure/gpt-4.1-mini " ,
" litellm_params " : { " model " : " azure/gpt-4.1-mini " } ,
" model_info " : { " base_model " : " gpt-4.1-mini " } ,
} ,
" expected " : " gpt-4.1-mini " ,
} ,
{
" model " : {
" model_name " : " openai/gpt-4.1-mini " ,
" litellm_params " : { " model " : " openai/gpt-4.1-mini " } ,
} ,
" expected " : " openai/gpt-4.1-mini " ,
} ,
{
" model " : {
" model_name " : " openai/gpt-4.1-mini " ,
" litellm_params " : { " model " : " openai/gpt-4.1-mini " } ,
" model_info " : { " base_model " : " gpt-4.1-mini " } ,
} ,
" expected " : " gpt-4.1-mini " ,
} ,
{
" model " : {
" model_name " : " claude-sonnet-4-5-20250929 " ,
" litellm_params " : { " model " : " anthropic/claude-sonnet-4-5@20250929 " } ,
" model_info " : { " base_model " : " anthropic/claude-sonnet-4-5-20250929 " } ,
} ,
" expected " : " anthropic/claude-sonnet-4-5-20250929 " ,
} ,
{
" model " : {
" model_name " : " gemini-2.5-flash-001 " ,
" litellm_params " : { " model " : " gemini/gemini-2.5-flash@001 " } ,
" model_info " : { " base_model " : " gemini-2.5-flash-001 " } ,
} ,
" expected " : " gemini-2.5-flash-001 " ,
} ,
] ,
)
def test_get_litellm_model_info ( data ) :
from litellm . proxy . proxy_server import get_litellm_model_info
model = data [ " model " ]
get_info_mock = MagicMock ( )
with mock . patch (
" litellm.get_model_info " ,
new = get_info_mock ,
) :
get_litellm_model_info ( model = model )
get_info_mock . assert_called_once_with ( data [ " expected " ] )