#### What this tests #### # This tests if the router timeout error handling during fallbacks import asyncio import os import time import traceback from typing import Final import pytest from unittest.mock import patch, MagicMock, AsyncMock from dotenv import load_dotenv import litellm from litellm import Router load_dotenv() def test_router_timeouts(): # Model list for OpenAI and Anthropic models model_list = [ { "model_name": "openai-gpt-4", "litellm_params": { "model": "azure/gpt-4.1-mini", "api_key": "os.environ/AZURE_AI_API_KEY", "api_base": "os.environ/AZURE_AI_API_BASE", "api_version": "os.environ/AZURE_API_VERSION", }, "tpm": 80000, }, { "model_name": "anthropic-claude-haiku-4-5", "litellm_params": { "model": "claude-haiku-4-5", "api_key": "os.environ/ANTHROPIC_API_KEY", "mock_response": "hello world", }, "tpm": 20000, }, ] fallbacks_list = [ {"openai-gpt-4": ["anthropic-claude-haiku-4-5"]}, ] # Configure router router = Router( model_list=model_list, fallbacks=fallbacks_list, routing_strategy="usage-based-routing", debug_level="INFO", set_verbose=True, redis_host=os.getenv("REDIS_HOST"), redis_password=os.getenv("REDIS_PASSWORD"), redis_port=int(os.getenv("REDIS_PORT")), timeout=10, num_retries=0, ) print("***** TPM SETTINGS *****") for model_object in model_list: print(f"{model_object['model_name']}: {model_object['tpm']} TPM") # Sample list of questions questions_list = [ {"content": "Tell me a very long joke.", "modality": "voice"}, ] total_tokens_used = 0 # Process each question for question in questions_list: messages = [{"content": question["content"], "role": "user"}] prompt_tokens = litellm.token_counter(text=question["content"], model="gpt-4") print("prompt_tokens = ", prompt_tokens) response = router.completion( model="openai-gpt-4", messages=messages, timeout=5, num_retries=0 ) total_tokens_used += response.usage.total_tokens print("Response:", response) print("********** TOKENS USED SO FAR = ", total_tokens_used) @pytest.mark.asyncio async def test_router_timeouts_bedrock(): from litellm._uuid import uuid import openai # Model list for OpenAI and Anthropic models _model_list = [ { "model_name": "bedrock", "litellm_params": { "model": "bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0", "timeout": 0.00001, }, "tpm": 80000, }, ] # Configure router router = Router( model_list=_model_list, routing_strategy="usage-based-routing", debug_level="DEBUG", set_verbose=True, num_retries=0, ) litellm.set_verbose = True try: response = await router.acompletion( model="bedrock", messages=[{"role": "user", "content": f"hello, who are u {uuid.uuid4()}"}], ) print(response) pytest.fail("Did not raise error `openai.APITimeoutError`") except openai.APITimeoutError as e: print( "Passed: Raised correct exception. Got openai.APITimeoutError\nGood Job", e ) print(type(e)) pass except Exception as e: pytest.fail( f"Did not raise error `openai.APITimeoutError`. Instead raised error type: {type(e)}, Error: {e}" ) @pytest.mark.parametrize( "num_retries, expected_call_count", [(0, 1), (1, 2), (2, 3), (3, 4)], ) def test_router_timeout_with_retries_anthropic_model(num_retries, expected_call_count): """ If request hits custom timeout, ensure it's retried. """ from litellm.llms.custom_httpx.http_handler import HTTPHandler litellm.num_retries = num_retries litellm.request_timeout = 0.000001 router = Router( model_list=[ { "model_name": "claude-3-haiku", "litellm_params": { "model": f"anthropic/{os.environ.get('CI_CD_DEFAULT_ANTHROPIC_MODEL', 'claude-haiku-4-5-20251001')}", }, } ], ) custom_client = HTTPHandler() with patch.object(custom_client, "post", new=MagicMock()) as mock_client: try: def delayed_response(*args, **kwargs): time.sleep(0.01) # Exceeds the 0.000001 timeout raise TimeoutError("Request timed out.") mock_client.side_effect = delayed_response router.completion( model="claude-3-haiku", messages=[{"role": "user", "content": "hello, who are u"}], client=custom_client, ) except litellm.Timeout: pass assert mock_client.call_count == expected_call_count @pytest.mark.parametrize( "model", [ "llama3", "bedrock-anthropic", ], ) def test_router_stream_timeout(model): import os from dotenv import load_dotenv import litellm from litellm.router import Router, RetryPolicy, AllowedFailsPolicy litellm.set_verbose = True model_list = [ { "model_name": "llama3", "litellm_params": { "model": "watsonx/meta-llama/llama-3-1-8b-instruct", "api_base": os.getenv("WATSONX_URL_US_SOUTH"), "api_key": os.getenv("WATSONX_API_KEY"), "project_id": os.getenv("WATSONX_PROJECT_ID_US_SOUTH"), "timeout": 0.01, "stream_timeout": 0.0000001, }, }, { "model_name": "bedrock-anthropic", "litellm_params": { "model": "bedrock/anthropic.claude-3-5-haiku-20241022-v1:0", "timeout": 0.01, "stream_timeout": 0.0000001, }, }, { "model_name": "llama3-fallback", "litellm_params": { "model": "gpt-3.5-turbo", "api_key": os.getenv("OPENAI_API_KEY"), }, }, ] # Initialize router with retry and timeout settings router = Router( model_list=model_list, fallbacks=[ {"llama3": ["llama3-fallback"]}, {"bedrock-anthropic": ["llama3-fallback"]}, ], routing_strategy="latency-based-routing", # 👈 set routing strategy retry_policy=RetryPolicy( TimeoutErrorRetries=1, # Number of retries for timeout errors RateLimitErrorRetries=3, BadRequestErrorRetries=2, ), allowed_fails_policy=AllowedFailsPolicy( TimeoutErrorAllowedFails=2, # Number of timeouts allowed before cooldown RateLimitErrorAllowedFails=2, ), cooldown_time=120, # Cooldown time in seconds, set_verbose=True, routing_strategy_args={"lowest_latency_buffer": 0.5}, ) print("this fall back does NOT work:") response = router.completion( model=model, messages=[ {"role": "system", "content": "You are a helpful assistant"}, {"role": "user", "content": "write a 100 word story about a cat"}, ], temperature=0.6, max_tokens=500, stream=True, ) t = 0 for chunk in response: assert "llama" not in chunk.model chunk_text = chunk.choices[0].delta.content or "" print(chunk_text) t += 1 if t > 10: break @pytest.mark.parametrize( "stream", [ True, False, ], ) def test_unit_test_streaming_timeout(stream): import os from dotenv import load_dotenv import litellm from litellm.router import Router, RetryPolicy, AllowedFailsPolicy litellm.set_verbose = True model_list = [ { "model_name": "llama3", "litellm_params": { "model": "watsonx/meta-llama/llama-3-1-8b-instruct", "api_base": os.getenv("WATSONX_URL_US_SOUTH"), "api_key": os.getenv("WATSONX_API_KEY"), "project_id": os.getenv("WATSONX_PROJECT_ID_US_SOUTH"), "timeout": 0.01, "stream_timeout": 0.0000001, }, }, { "model_name": "bedrock-anthropic", "litellm_params": { "model": "bedrock/anthropic.claude-3-5-haiku-20241022-v1:0", "timeout": 0.01, "stream_timeout": 0.0000001, }, }, { "model_name": "llama3-fallback", "litellm_params": { "model": "gpt-3.5-turbo", "api_key": os.getenv("OPENAI_API_KEY"), }, }, ] router = Router(model_list=model_list) stream_timeout = 0.0000001 normal_timeout = 0.01 args = { "kwargs": {"stream": stream}, "data": {"timeout": normal_timeout, "stream_timeout": stream_timeout}, } assert router._get_stream_timeout(**args) == stream_timeout assert router._get_non_stream_timeout(**args) == normal_timeout stream_timeout_val = router._get_timeout( kwargs={"stream": stream}, data={"timeout": normal_timeout, "stream_timeout": stream_timeout}, ) if stream: assert stream_timeout_val == stream_timeout else: assert stream_timeout_val == normal_timeout @pytest.mark.parametrize( "request_kwargs, expected_timeout", [ ({"service_tier": "flex"}, 900.0), ({"service_tier": "default"}, 610.0), ({}, 610.0), ({"service_tier": "flex", "timeout": 20}, 20), ({"service_tier": "flex", "stream": True}, 950.0), ({"service_tier": "default", "stream": True}, 610.0), ({"service_tier": "flex", "stream": True, "stream_timeout": 30}, 30), ], ) def test_the_deployment_timeout_for_the_requests_service_tier_wins_over_its_general_timeout( request_kwargs: dict[str, object], expected_timeout: float ) -> None: router: Final = Router( model_list=[ { "model_name": "openai-gpt-5.1", "litellm_params": { "model": "openai/gpt-5.1", "api_key": "sk-test", "timeout": 610, "stream_timeout": 610, "timeout_by_service_tier": {"flex": 900}, "stream_timeout_by_service_tier": {"flex": 950}, }, } ] ) deployment_params: Final = router.model_list[0]["litellm_params"] assert router._get_timeout(kwargs=request_kwargs, data=deployment_params) == expected_timeout def test_a_stream_keeps_the_deployment_stream_timeout_when_only_the_request_timeout_map_names_its_tier() -> None: router: Final = Router( model_list=[ { "model_name": "openai-gpt-5.1", "litellm_params": { "model": "openai/gpt-5.1", "api_key": "sk-test", "timeout": 610, "stream_timeout": 30, "timeout_by_service_tier": {"flex": 900}, }, } ] ) deployment_params: Final = router.model_list[0]["litellm_params"] assert router._get_timeout(kwargs={"service_tier": "flex", "stream": True}, data=deployment_params) == 30.0 assert router._get_timeout(kwargs={"service_tier": "flex"}, data=deployment_params) == 900.0