ResponsesAPIRequestUtils

litellm/responses/main.py

@@ -9,7 +9,7 @@ import litellm
 from litellm.litellm_core_utils.litellm_logging import Logging as LiteLLMLoggingObj
 from litellm.llms.base_llm.responses.transformation import BaseResponsesAPIConfig
 from litellm.llms.custom_httpx.llm_http_handler import BaseLLMHTTPHandler
-from litellm.responses.utils import get_optional_params_responses_api
+from litellm.responses.utils import ResponsesAPIRequestUtils
 from litellm.types.llms.openai import (
     Reasoning,
     ResponseIncludable,
@@ -31,23 +31,6 @@ base_llm_http_handler = BaseLLMHTTPHandler()
 #################################################
 
 
-def get_requested_response_api_optional_param(
-    params: Dict[str, Any]
-) -> ResponsesAPIOptionalRequestParams:
-    """
-    Filter parameters to only include those defined in ResponsesAPIOptionalRequestParams.
-
-    Args:
-        params: Dictionary of parameters to filter
-
-    Returns:
-        ResponsesAPIOptionalRequestParams instance with only the valid parameters
-    """
-    valid_keys = get_type_hints(ResponsesAPIOptionalRequestParams).keys()
-    filtered_params = {k: v for k, v in params.items() if k in valid_keys}
-    return ResponsesAPIOptionalRequestParams(**filtered_params)
-
-
 @client
 async def aresponses(
     input: Union[str, ResponseInputParam],
@@ -190,14 +173,16 @@ def responses(
     local_vars.update(kwargs)
     # Get ResponsesAPIOptionalRequestParams with only valid parameters
     response_api_optional_params: ResponsesAPIOptionalRequestParams = (
-        get_requested_response_api_optional_param(local_vars)
+        ResponsesAPIRequestUtils.get_requested_response_api_optional_param(local_vars)
     )
 
     # Get optional parameters for the responses API
-    responses_api_request_params: Dict = get_optional_params_responses_api(
-        model=model,
-        responses_api_provider_config=responses_api_provider_config,
-        response_api_optional_params=response_api_optional_params,
+    responses_api_request_params: Dict = (
+        ResponsesAPIRequestUtils.get_optional_params_responses_api(
+            model=model,
+            responses_api_provider_config=responses_api_provider_config,
+            response_api_optional_params=response_api_optional_params,
+        )
     )
 
     # Pre Call logging

litellm/responses/utils.py

@@ -1,56 +1,79 @@
-import json
-from typing import Any, Dict
+from typing import Any, Dict, get_type_hints
 
 import litellm
 from litellm.llms.base_llm.responses.transformation import BaseResponsesAPIConfig
 from litellm.types.llms.openai import (
     ResponseAPIUsage,
     ResponsesAPIOptionalRequestParams,
-    ResponsesAPIRequestParams,
 )
 from litellm.types.utils import Usage
 
 
-def get_optional_params_responses_api(
-    model: str,
-    responses_api_provider_config: BaseResponsesAPIConfig,
-    response_api_optional_params: ResponsesAPIOptionalRequestParams,
-) -> Dict:
-    """
-    Get optional parameters for the responses API.
+class ResponsesAPIRequestUtils:
+    """Helper utils for constructing ResponseAPI requests"""
 
-    Args:
-        params: Dictionary of all parameters
-        model: The model name
-        responses_api_provider_config: The provider configuration for responses API
+    @staticmethod
+    def get_optional_params_responses_api(
+        model: str,
+        responses_api_provider_config: BaseResponsesAPIConfig,
+        response_api_optional_params: ResponsesAPIOptionalRequestParams,
+    ) -> Dict:
+        """
+        Get optional parameters for the responses API.
 
-    Returns:
-        A dictionary of supported parameters for the responses API
-    """
-    # Remove None values and internal parameters
+        Args:
+            params: Dictionary of all parameters
+            model: The model name
+            responses_api_provider_config: The provider configuration for responses API
 
-    # Get supported parameters for the model
-    supported_params = responses_api_provider_config.get_supported_openai_params(model)
+        Returns:
+            A dictionary of supported parameters for the responses API
+        """
+        # Remove None values and internal parameters
 
-    # Check for unsupported parameters
-    unsupported_params = [
-        param for param in response_api_optional_params if param not in supported_params
-    ]
-
-    if unsupported_params:
-        raise litellm.UnsupportedParamsError(
-            model=model,
-            message=f"The following parameters are not supported for model {model}: {', '.join(unsupported_params)}",
+        # Get supported parameters for the model
+        supported_params = responses_api_provider_config.get_supported_openai_params(
+            model
         )
 
-    # Map parameters to provider-specific format
-    mapped_params = responses_api_provider_config.map_openai_params(
-        response_api_optional_params=response_api_optional_params,
-        model=model,
-        drop_params=litellm.drop_params,
-    )
+        # Check for unsupported parameters
+        unsupported_params = [
+            param
+            for param in response_api_optional_params
+            if param not in supported_params
+        ]
 
-    return mapped_params
+        if unsupported_params:
+            raise litellm.UnsupportedParamsError(
+                model=model,
+                message=f"The following parameters are not supported for model {model}: {', '.join(unsupported_params)}",
+            )
+
+        # Map parameters to provider-specific format
+        mapped_params = responses_api_provider_config.map_openai_params(
+            response_api_optional_params=response_api_optional_params,
+            model=model,
+            drop_params=litellm.drop_params,
+        )
+
+        return mapped_params
+
+    @staticmethod
+    def get_requested_response_api_optional_param(
+        params: Dict[str, Any]
+    ) -> ResponsesAPIOptionalRequestParams:
+        """
+        Filter parameters to only include those defined in ResponsesAPIOptionalRequestParams.
+
+        Args:
+            params: Dictionary of parameters to filter
+
+        Returns:
+            ResponsesAPIOptionalRequestParams instance with only the valid parameters
+        """
+        valid_keys = get_type_hints(ResponsesAPIOptionalRequestParams).keys()
+        filtered_params = {k: v for k, v in params.items() if k in valid_keys}
+        return ResponsesAPIOptionalRequestParams(**filtered_params)
 
 
 class ResponseAPILoggingUtils: