openrouter 0.1.2__py3-none-any.whl → 0.6.0__py3-none-any.whl

openrouter/responses.py

@@ -22,6 +22,8 @@ class Responses(BaseSDK):
     def send(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -84,16 +86,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Union[Literal[False], None] = None,
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -106,6 +102,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -150,6 +151,8 @@ class Responses(BaseSDK):
     def send(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -212,16 +215,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Literal[True],
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -234,6 +231,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -277,6 +279,8 @@ class Responses(BaseSDK):
     def send(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -339,16 +343,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Optional[bool] = False,
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -361,6 +359,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -410,56 +413,60 @@ class Responses(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = components.OpenResponsesRequest(
-            input=utils.get_pydantic_model(
-                input, Optional[components.OpenResponsesInput]
-            ),
-            instructions=instructions,
-            metadata=metadata,
-            tools=utils.get_pydantic_model(
-                tools, Optional[List[components.OpenResponsesRequestToolUnion]]
-            ),
-            tool_choice=utils.get_pydantic_model(
-                tool_choice, Optional[components.OpenAIResponsesToolChoiceUnion]
-            ),
-            parallel_tool_calls=parallel_tool_calls,
-            model=model,
-            models=models,
-            text=utils.get_pydantic_model(
-                text, Optional[components.OpenResponsesResponseText]
-            ),
-            reasoning=utils.get_pydantic_model(
-                reasoning, OptionalNullable[components.OpenResponsesReasoningConfig]
-            ),
-            max_output_tokens=max_output_tokens,
-            temperature=temperature,
-            top_p=top_p,
-            top_logprobs=top_logprobs,
-            max_tool_calls=max_tool_calls,
-            presence_penalty=presence_penalty,
-            frequency_penalty=frequency_penalty,
-            top_k=top_k,
-            image_config=image_config,
-            modalities=modalities,
-            prompt_cache_key=prompt_cache_key,
-            previous_response_id=previous_response_id,
-            prompt=utils.get_pydantic_model(
-                prompt, OptionalNullable[components.OpenAIResponsesPrompt]
-            ),
-            include=include,
-            background=background,
-            safety_identifier=safety_identifier,
-            service_tier=service_tier,
-            truncation=truncation,
-            stream=stream,
-            provider=utils.get_pydantic_model(
-                provider, OptionalNullable[components.OpenResponsesRequestProvider]
-            ),
-            plugins=utils.get_pydantic_model(
-                plugins, Optional[List[components.OpenResponsesRequestPluginUnion]]
+        request = operations.CreateResponsesRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+            open_responses_request=components.OpenResponsesRequest(
+                input=utils.get_pydantic_model(
+                    input, Optional[components.OpenResponsesInput]
+                ),
+                instructions=instructions,
+                metadata=metadata,
+                tools=utils.get_pydantic_model(
+                    tools, Optional[List[components.OpenResponsesRequestToolUnion]]
+                ),
+                tool_choice=utils.get_pydantic_model(
+                    tool_choice, Optional[components.OpenAIResponsesToolChoiceUnion]
+                ),
+                parallel_tool_calls=parallel_tool_calls,
+                model=model,
+                models=models,
+                text=utils.get_pydantic_model(
+                    text, Optional[components.OpenResponsesResponseText]
+                ),
+                reasoning=utils.get_pydantic_model(
+                    reasoning, OptionalNullable[components.OpenResponsesReasoningConfig]
+                ),
+                max_output_tokens=max_output_tokens,
+                temperature=temperature,
+                top_p=top_p,
+                top_logprobs=top_logprobs,
+                max_tool_calls=max_tool_calls,
+                presence_penalty=presence_penalty,
+                frequency_penalty=frequency_penalty,
+                top_k=top_k,
+                image_config=image_config,
+                modalities=modalities,
+                prompt_cache_key=prompt_cache_key,
+                previous_response_id=previous_response_id,
+                prompt=utils.get_pydantic_model(
+                    prompt, OptionalNullable[components.OpenAIResponsesPrompt]
+                ),
+                include=include,
+                background=background,
+                safety_identifier=safety_identifier,
+                service_tier=service_tier,
+                truncation=truncation,
+                stream=stream,
+                provider=utils.get_pydantic_model(
+                    provider, OptionalNullable[components.Provider]
+                ),
+                plugins=utils.get_pydantic_model(
+                    plugins, Optional[List[components.Plugin]]
+                ),
+                user=user,
+                session_id=session_id,
             ),
-            user=user,
-            session_id=session_id,
         )
 
         req = self._build_request(
@@ -474,9 +481,17 @@ class Responses(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="text/event-stream" if stream else "application/json",
             http_headers=http_headers,
+            _globals=operations.CreateResponsesGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request, False, False, "json", components.OpenResponsesRequest
+                request.open_responses_request,
+                False,
+                False,
+                "json",
+                components.OpenResponsesRequest,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -655,6 +670,8 @@ class Responses(BaseSDK):
     async def send_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -717,16 +734,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Union[Literal[False], None] = None,
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -739,6 +750,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -783,6 +799,8 @@ class Responses(BaseSDK):
     async def send_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -845,16 +863,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Literal[True],
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -867,6 +879,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -910,6 +927,8 @@ class Responses(BaseSDK):
     async def send_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         input: Optional[
             Union[components.OpenResponsesInput, components.OpenResponsesInputTypedDict]
         ] = None,
@@ -972,16 +991,10 @@ class Responses(BaseSDK):
         truncation: OptionalNullable[components.Truncation] = UNSET,
         stream: Optional[bool] = False,
         provider: OptionalNullable[
-            Union[
-                components.OpenResponsesRequestProvider,
-                components.OpenResponsesRequestProviderTypedDict,
-            ]
+            Union[components.Provider, components.ProviderTypedDict]
         ] = UNSET,
         plugins: Optional[
-            Union[
-                List[components.OpenResponsesRequestPluginUnion],
-                List[components.OpenResponsesRequestPluginUnionTypedDict],
-            ]
+            Union[List[components.Plugin], List[components.PluginTypedDict]]
         ] = None,
         user: Optional[str] = None,
         session_id: Optional[str] = None,
@@ -994,6 +1007,11 @@ class Responses(BaseSDK):
 
         Creates a streaming or non-streaming response using OpenResponses API format
 
+        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+
+        :param x_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+
         :param input: Input for a response request - can be a string or array of items
         :param instructions:
         :param metadata: Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
@@ -1043,56 +1061,60 @@ class Responses(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = components.OpenResponsesRequest(
-            input=utils.get_pydantic_model(
-                input, Optional[components.OpenResponsesInput]
-            ),
-            instructions=instructions,
-            metadata=metadata,
-            tools=utils.get_pydantic_model(
-                tools, Optional[List[components.OpenResponsesRequestToolUnion]]
-            ),
-            tool_choice=utils.get_pydantic_model(
-                tool_choice, Optional[components.OpenAIResponsesToolChoiceUnion]
-            ),
-            parallel_tool_calls=parallel_tool_calls,
-            model=model,
-            models=models,
-            text=utils.get_pydantic_model(
-                text, Optional[components.OpenResponsesResponseText]
-            ),
-            reasoning=utils.get_pydantic_model(
-                reasoning, OptionalNullable[components.OpenResponsesReasoningConfig]
-            ),
-            max_output_tokens=max_output_tokens,
-            temperature=temperature,
-            top_p=top_p,
-            top_logprobs=top_logprobs,
-            max_tool_calls=max_tool_calls,
-            presence_penalty=presence_penalty,
-            frequency_penalty=frequency_penalty,
-            top_k=top_k,
-            image_config=image_config,
-            modalities=modalities,
-            prompt_cache_key=prompt_cache_key,
-            previous_response_id=previous_response_id,
-            prompt=utils.get_pydantic_model(
-                prompt, OptionalNullable[components.OpenAIResponsesPrompt]
-            ),
-            include=include,
-            background=background,
-            safety_identifier=safety_identifier,
-            service_tier=service_tier,
-            truncation=truncation,
-            stream=stream,
-            provider=utils.get_pydantic_model(
-                provider, OptionalNullable[components.OpenResponsesRequestProvider]
-            ),
-            plugins=utils.get_pydantic_model(
-                plugins, Optional[List[components.OpenResponsesRequestPluginUnion]]
+        request = operations.CreateResponsesRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+            open_responses_request=components.OpenResponsesRequest(
+                input=utils.get_pydantic_model(
+                    input, Optional[components.OpenResponsesInput]
+                ),
+                instructions=instructions,
+                metadata=metadata,
+                tools=utils.get_pydantic_model(
+                    tools, Optional[List[components.OpenResponsesRequestToolUnion]]
+                ),
+                tool_choice=utils.get_pydantic_model(
+                    tool_choice, Optional[components.OpenAIResponsesToolChoiceUnion]
+                ),
+                parallel_tool_calls=parallel_tool_calls,
+                model=model,
+                models=models,
+                text=utils.get_pydantic_model(
+                    text, Optional[components.OpenResponsesResponseText]
+                ),
+                reasoning=utils.get_pydantic_model(
+                    reasoning, OptionalNullable[components.OpenResponsesReasoningConfig]
+                ),
+                max_output_tokens=max_output_tokens,
+                temperature=temperature,
+                top_p=top_p,
+                top_logprobs=top_logprobs,
+                max_tool_calls=max_tool_calls,
+                presence_penalty=presence_penalty,
+                frequency_penalty=frequency_penalty,
+                top_k=top_k,
+                image_config=image_config,
+                modalities=modalities,
+                prompt_cache_key=prompt_cache_key,
+                previous_response_id=previous_response_id,
+                prompt=utils.get_pydantic_model(
+                    prompt, OptionalNullable[components.OpenAIResponsesPrompt]
+                ),
+                include=include,
+                background=background,
+                safety_identifier=safety_identifier,
+                service_tier=service_tier,
+                truncation=truncation,
+                stream=stream,
+                provider=utils.get_pydantic_model(
+                    provider, OptionalNullable[components.Provider]
+                ),
+                plugins=utils.get_pydantic_model(
+                    plugins, Optional[List[components.Plugin]]
+                ),
+                user=user,
+                session_id=session_id,
             ),
-            user=user,
-            session_id=session_id,
         )
 
         req = self._build_request_async(
@@ -1107,9 +1129,17 @@ class Responses(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="text/event-stream" if stream else "application/json",
             http_headers=http_headers,
+            _globals=operations.CreateResponsesGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request, False, False, "json", components.OpenResponsesRequest
+                request.open_responses_request,
+                False,
+                False,
+                "json",
+                components.OpenResponsesRequest,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,

openrouter/sdk.py

@@ -20,19 +20,18 @@ if TYPE_CHECKING:
     from openrouter.api_keys import APIKeys
     from openrouter.beta import Beta
     from openrouter.chat import Chat
-    from openrouter.completions import Completions
     from openrouter.credits import Credits
     from openrouter.embeddings import Embeddings
     from openrouter.endpoints import Endpoints
     from openrouter.generations import Generations
+    from openrouter.guardrails import Guardrails
     from openrouter.models_ import Models
     from openrouter.oauth import OAuth
-    from openrouter.parameters import Parameters
     from openrouter.providers import Providers
 
 
 class OpenRouter(BaseSDK):
-    r"""OpenRouter API: OpenAI-compatible Chat Completions and Completions API with additional OpenRouter features
+    r"""OpenRouter API: OpenAI-compatible API with additional OpenRouter features
     https://openrouter.ai/docs - OpenRouter Documentation
     """
 
@@ -49,16 +48,15 @@ class OpenRouter(BaseSDK):
     r"""Model information endpoints"""
     endpoints: "Endpoints"
     r"""Endpoint information"""
-    parameters: "Parameters"
-    r"""Parameters endpoints"""
     providers: "Providers"
     r"""Provider information endpoints"""
     api_keys: "APIKeys"
     r"""API key management endpoints"""
+    guardrails: "Guardrails"
+    r"""Guardrails endpoints"""
     o_auth: "OAuth"
     r"""OAuth authentication endpoints"""
     chat: "Chat"
-    completions: "Completions"
     _sub_sdk_map = {
         "beta": ("openrouter.beta", "Beta"),
         "analytics": ("openrouter.analytics", "Analytics"),
@@ -67,12 +65,11 @@ class OpenRouter(BaseSDK):
         "generations": ("openrouter.generations", "Generations"),
         "models": ("openrouter.models_", "Models"),
         "endpoints": ("openrouter.endpoints", "Endpoints"),
-        "parameters": ("openrouter.parameters", "Parameters"),
         "providers": ("openrouter.providers", "Providers"),
         "api_keys": ("openrouter.api_keys", "APIKeys"),
+        "guardrails": ("openrouter.guardrails", "Guardrails"),
         "o_auth": ("openrouter.oauth", "OAuth"),
         "chat": ("openrouter.chat", "Chat"),
-        "completions": ("openrouter.completions", "Completions"),
     }
 
     def __init__(