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

openrouter/credits.py

@@ -15,6 +15,8 @@ class Credits(BaseSDK):
     def get_credits(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -22,7 +24,12 @@ class Credits(BaseSDK):
     ) -> operations.GetCreditsResponse:
         r"""Get remaining credits
 
-        Get total credits purchased and used for the authenticated user
+        Get total credits purchased and used for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -38,18 +45,28 @@ class Credits(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.GetCreditsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request(
             method="GET",
             path="/credits",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.GetCreditsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -112,6 +129,8 @@ class Credits(BaseSDK):
     async def get_credits_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -119,7 +138,12 @@ class Credits(BaseSDK):
     ) -> operations.GetCreditsResponse:
         r"""Get remaining credits
 
-        Get total credits purchased and used for the authenticated user
+        Get total credits purchased and used for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -135,18 +159,28 @@ class Credits(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.GetCreditsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request_async(
             method="GET",
             path="/credits",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.GetCreditsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -216,6 +250,8 @@ class Credits(BaseSDK):
         amount: float,
         sender: str,
         chain_id: components.ChainID,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -229,6 +265,11 @@ class Credits(BaseSDK):
         :param amount:
         :param sender:
         :param chain_id:
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -244,10 +285,14 @@ class Credits(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = components.CreateChargeRequest(
-            amount=amount,
-            sender=sender,
-            chain_id=chain_id,
+        request = operations.CreateCoinbaseChargeRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+            create_charge_request=components.CreateChargeRequest(
+                amount=amount,
+                sender=sender,
+                chain_id=chain_id,
+            ),
         )
 
         req = self._build_request(
@@ -262,11 +307,19 @@ class Credits(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.CreateCoinbaseChargeGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=utils.get_pydantic_model(
                 security, operations.CreateCoinbaseChargeSecurity
             ),
             get_serialized_body=lambda: utils.serialize_request_body(
-                request, False, False, "json", components.CreateChargeRequest
+                request.create_charge_request,
+                False,
+                False,
+                "json",
+                components.CreateChargeRequest,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -341,6 +394,8 @@ class Credits(BaseSDK):
         amount: float,
         sender: str,
         chain_id: components.ChainID,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -354,6 +409,11 @@ class Credits(BaseSDK):
         :param amount:
         :param sender:
         :param chain_id:
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -369,10 +429,14 @@ class Credits(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = components.CreateChargeRequest(
-            amount=amount,
-            sender=sender,
-            chain_id=chain_id,
+        request = operations.CreateCoinbaseChargeRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+            create_charge_request=components.CreateChargeRequest(
+                amount=amount,
+                sender=sender,
+                chain_id=chain_id,
+            ),
         )
 
         req = self._build_request_async(
@@ -387,11 +451,19 @@ class Credits(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.CreateCoinbaseChargeGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=utils.get_pydantic_model(
                 security, operations.CreateCoinbaseChargeSecurity
             ),
             get_serialized_body=lambda: utils.serialize_request_body(
-                request, False, False, "json", components.CreateChargeRequest
+                request.create_charge_request,
+                False,
+                False,
+                "json",
+                components.CreateChargeRequest,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,

openrouter/embeddings.py

@@ -23,6 +23,8 @@ class Embeddings(BaseSDK):
         *,
         input: Union[operations.InputUnion, operations.InputUnionTypedDict],
         model: str,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         encoding_format: Optional[operations.EncodingFormat] = None,
         dimensions: Optional[int] = None,
         user: Optional[str] = None,
@@ -44,6 +46,11 @@ class Embeddings(BaseSDK):
 
         :param input:
         :param model:
+        :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 encoding_format:
         :param dimensions:
         :param user:
@@ -66,15 +73,19 @@ class Embeddings(BaseSDK):
             base_url = self._get_url(base_url, url_variables)
 
         request = operations.CreateEmbeddingsRequest(
-            input=utils.get_pydantic_model(input, operations.InputUnion),
-            model=model,
-            encoding_format=encoding_format,
-            dimensions=dimensions,
-            user=user,
-            provider=utils.get_pydantic_model(
-                provider, Optional[components.ProviderPreferences]
+            http_referer=http_referer,
+            x_title=x_title,
+            request_body=operations.CreateEmbeddingsRequestBody(
+                input=utils.get_pydantic_model(input, operations.InputUnion),
+                model=model,
+                encoding_format=encoding_format,
+                dimensions=dimensions,
+                user=user,
+                provider=utils.get_pydantic_model(
+                    provider, Optional[components.ProviderPreferences]
+                ),
+                input_type=input_type,
             ),
-            input_type=input_type,
         )
 
         req = self._build_request(
@@ -91,9 +102,17 @@ class Embeddings(BaseSDK):
             if accept_header_override is not None
             else "application/json;q=1, text/event-stream;q=0",
             http_headers=http_headers,
+            _globals=operations.CreateEmbeddingsGlobals(
+                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", operations.CreateEmbeddingsRequest
+                request.request_body,
+                False,
+                False,
+                "json",
+                operations.CreateEmbeddingsRequestBody,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -210,6 +229,8 @@ class Embeddings(BaseSDK):
         *,
         input: Union[operations.InputUnion, operations.InputUnionTypedDict],
         model: str,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         encoding_format: Optional[operations.EncodingFormat] = None,
         dimensions: Optional[int] = None,
         user: Optional[str] = None,
@@ -231,6 +252,11 @@ class Embeddings(BaseSDK):
 
         :param input:
         :param model:
+        :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 encoding_format:
         :param dimensions:
         :param user:
@@ -253,15 +279,19 @@ class Embeddings(BaseSDK):
             base_url = self._get_url(base_url, url_variables)
 
         request = operations.CreateEmbeddingsRequest(
-            input=utils.get_pydantic_model(input, operations.InputUnion),
-            model=model,
-            encoding_format=encoding_format,
-            dimensions=dimensions,
-            user=user,
-            provider=utils.get_pydantic_model(
-                provider, Optional[components.ProviderPreferences]
+            http_referer=http_referer,
+            x_title=x_title,
+            request_body=operations.CreateEmbeddingsRequestBody(
+                input=utils.get_pydantic_model(input, operations.InputUnion),
+                model=model,
+                encoding_format=encoding_format,
+                dimensions=dimensions,
+                user=user,
+                provider=utils.get_pydantic_model(
+                    provider, Optional[components.ProviderPreferences]
+                ),
+                input_type=input_type,
             ),
-            input_type=input_type,
         )
 
         req = self._build_request_async(
@@ -278,9 +308,17 @@ class Embeddings(BaseSDK):
             if accept_header_override is not None
             else "application/json;q=1, text/event-stream;q=0",
             http_headers=http_headers,
+            _globals=operations.CreateEmbeddingsGlobals(
+                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", operations.CreateEmbeddingsRequest
+                request.request_body,
+                False,
+                False,
+                "json",
+                operations.CreateEmbeddingsRequestBody,
             ),
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -395,6 +433,8 @@ class Embeddings(BaseSDK):
     def list_models(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -404,6 +444,11 @@ class Embeddings(BaseSDK):
 
         Returns a list of all available embeddings models and their properties
 
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -418,18 +463,28 @@ class Embeddings(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.ListEmbeddingsModelsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request(
             method="GET",
             path="/embeddings/models",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEmbeddingsModelsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -487,6 +542,8 @@ class Embeddings(BaseSDK):
     async def list_models_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -496,6 +553,11 @@ class Embeddings(BaseSDK):
 
         Returns a list of all available embeddings models and their properties
 
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -510,18 +572,28 @@ class Embeddings(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.ListEmbeddingsModelsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request_async(
             method="GET",
             path="/embeddings/models",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEmbeddingsModelsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,

openrouter/endpoints.py

@@ -17,6 +17,8 @@ class Endpoints(BaseSDK):
         *,
         author: str,
         slug: str,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -26,6 +28,11 @@ class Endpoints(BaseSDK):
 
         :param author:
         :param slug:
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -42,6 +49,8 @@ class Endpoints(BaseSDK):
             base_url = self._get_url(base_url, url_variables)
 
         request = operations.ListEndpointsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
             author=author,
             slug=slug,
         )
@@ -58,6 +67,10 @@ class Endpoints(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEndpointsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -117,6 +130,8 @@ class Endpoints(BaseSDK):
         *,
         author: str,
         slug: str,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -126,6 +141,11 @@ class Endpoints(BaseSDK):
 
         :param author:
         :param slug:
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -142,6 +162,8 @@ class Endpoints(BaseSDK):
             base_url = self._get_url(base_url, url_variables)
 
         request = operations.ListEndpointsRequest(
+            http_referer=http_referer,
+            x_title=x_title,
             author=author,
             slug=slug,
         )
@@ -158,6 +180,10 @@ class Endpoints(BaseSDK):
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEndpointsGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -215,6 +241,8 @@ class Endpoints(BaseSDK):
     def list_zdr_endpoints(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -222,6 +250,11 @@ class Endpoints(BaseSDK):
     ) -> operations.ListEndpointsZdrResponse:
         r"""Preview the impact of ZDR on the available endpoints
 
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -236,18 +269,28 @@ class Endpoints(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.ListEndpointsZdrRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request(
             method="GET",
             path="/endpoints/zdr",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEndpointsZdrGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,
@@ -302,6 +345,8 @@ class Endpoints(BaseSDK):
     async def list_zdr_endpoints_async(
         self,
         *,
+        http_referer: Optional[str] = None,
+        x_title: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -309,6 +354,11 @@ class Endpoints(BaseSDK):
     ) -> operations.ListEndpointsZdrResponse:
         r"""Preview the impact of ZDR on the available endpoints
 
+        :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 retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -323,18 +373,28 @@ class Endpoints(BaseSDK):
             base_url = server_url
         else:
             base_url = self._get_url(base_url, url_variables)
+
+        request = operations.ListEndpointsZdrRequest(
+            http_referer=http_referer,
+            x_title=x_title,
+        )
+
         req = self._build_request_async(
             method="GET",
             path="/endpoints/zdr",
             base_url=base_url,
             url_variables=url_variables,
-            request=None,
+            request=request,
             request_body_required=False,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
+            _globals=operations.ListEndpointsZdrGlobals(
+                http_referer=self.sdk_configuration.globals.http_referer,
+                x_title=self.sdk_configuration.globals.x_title,
+            ),
             security=self.sdk_configuration.security,
             allow_empty_value=None,
             timeout_ms=timeout_ms,