@openrouter/sdk 0.0.0-beta.39 → 0.0.0-beta.40

package/docs/sdks/generations/README.md

@@ -7,15 +7,15 @@ Generation history endpoints
 
 ### Available Operations
 
-* [getMetadata](#getmetadata) - Get request & usage metadata for a generation
+* [getGeneration](#getgeneration) - Get request & usage metadata for a generation
 
-## getMetadata
+## getGeneration
 
 Get request & usage metadata for a generation
 
 ### Example Usage
 
-<!-- UsageSnippet language="typescript" operationID="getMetadata" method="get" path="/generation" -->
+<!-- UsageSnippet language="typescript" operationID="getGeneration" method="get" path="/generation" -->
 ```typescript
 import { OpenRouter } from "@openrouter/sdk";
 
@@ -24,7 +24,7 @@ const openRouter = new OpenRouter({
 });
 
 async function run() {
-  const result = await openRouter.generations.getMetadata({
+  const result = await openRouter.generations.getGeneration({
     id: "<id>",
   });
 
@@ -40,7 +40,7 @@ The standalone function version of this method:
 
 ```typescript
 import { OpenRouterCore } from "@openrouter/sdk/core.js";
-import { generationsGetMetadata } from "@openrouter/sdk/funcs/generationsGetMetadata.js";
+import { generationsGetGeneration } from "@openrouter/sdk/funcs/generationsGetGeneration.js";
 
 // Use `OpenRouterCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -49,14 +49,14 @@ const openRouter = new OpenRouterCore({
 });
 
 async function run() {
-  const res = await generationsGetMetadata(openRouter, {
+  const res = await generationsGetGeneration(openRouter, {
     id: "<id>",
   });
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("generationsGetMetadata failed:", res.error);
+    console.log("generationsGetGeneration failed:", res.error);
   }
 }
 
@@ -76,37 +76,36 @@ associated utilities.
 ```tsx
 import {
   // Query hooks for fetching data.
-  useGenerationsGetMetadata,
-  useGenerationsGetMetadataSuspense,
+  useGenerationsGetGeneration,
+  useGenerationsGetGenerationSuspense,
 
   // Utility for prefetching data during server-side rendering and in React
   // Server Components that will be immediately available to client components
   // using the hooks.
-  prefetchGenerationsGetMetadata,
+  prefetchGenerationsGetGeneration,
   
   // Utilities to invalidate the query cache for this query in response to
   // mutations and other user actions.
-  invalidateGenerationsGetMetadata,
-  invalidateAllGenerationsGetMetadata,
-} from "@openrouter/sdk/react-query/generationsGetMetadata.js";
+  invalidateGenerationsGetGeneration,
+  invalidateAllGenerationsGetGeneration,
+} from "@openrouter/sdk/react-query/generationsGetGeneration.js";
 ```
 
 ### Parameters
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.GetMetadataRequest](../../models/operations/getmetadatarequest.md)                                                                                                 | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `request`                                                                                                                                                                      | [operations.GetGenerationRequest](../../models/operations/getgenerationrequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
 
 ### Response
 
-**Promise\<[operations.GetMetadataResponse](../../models/operations/getmetadataresponse.md)\>**
+**Promise\<[operations.GetGenerationResponse](../../models/operations/getgenerationresponse.md)\>**
 
 ### Errors
 
-| Error Type           | Status Code          | Content Type         |
-| -------------------- | -------------------- | -------------------- |
-| errors.ErrorResponse | 4XX                  | application/json     |
-| errors.ErrorResponse | 5XX                  | application/json     |
+| Error Type                    | Status Code                   | Content Type                  |
+| ----------------------------- | ----------------------------- | ----------------------------- |
+| errors.OpenRouterDefaultError | 4XX, 5XX                      | \*/\*                         |

package/docs/sdks/models/README.md

@@ -7,17 +7,17 @@ Model information endpoints
 
 ### Available Operations
 
-* [getCount](#getcount) - Get total count of available models
-* [list](#list) - List all models and their properties
-* [listUserModels](#listusermodels) - List models filtered by user provider preferences
+* [listModelsCount](#listmodelscount) - Get total count of available models
+* [getModels](#getmodels) - List all models and their properties
+* [listModelsUser](#listmodelsuser) - List models filtered by user provider preferences
 
-## getCount
+## listModelsCount
 
 Get total count of available models
 
 ### Example Usage
 
-<!-- UsageSnippet language="typescript" operationID="getCount" method="get" path="/models/count" -->
+<!-- UsageSnippet language="typescript" operationID="listModelsCount" method="get" path="/models/count" -->
 ```typescript
 import { OpenRouter } from "@openrouter/sdk";
 
@@ -26,7 +26,7 @@ const openRouter = new OpenRouter({
 });
 
 async function run() {
-  const result = await openRouter.models.getCount();
+  const result = await openRouter.models.listModelsCount();
 
   console.log(result);
 }
@@ -40,7 +40,7 @@ The standalone function version of this method:
 
 ```typescript
 import { OpenRouterCore } from "@openrouter/sdk/core.js";
-import { modelsGetCount } from "@openrouter/sdk/funcs/modelsGetCount.js";
+import { modelsListModelsCount } from "@openrouter/sdk/funcs/modelsListModelsCount.js";
 
 // Use `OpenRouterCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -49,12 +49,12 @@ const openRouter = new OpenRouterCore({
 });
 
 async function run() {
-  const res = await modelsGetCount(openRouter);
+  const res = await modelsListModelsCount(openRouter);
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("modelsGetCount failed:", res.error);
+    console.log("modelsListModelsCount failed:", res.error);
   }
 }
 
@@ -74,18 +74,18 @@ associated utilities.
 ```tsx
 import {
   // Query hooks for fetching data.
-  useModelsGetCount,
-  useModelsGetCountSuspense,
+  useModelsListModelsCount,
+  useModelsListModelsCountSuspense,
 
   // Utility for prefetching data during server-side rendering and in React
   // Server Components that will be immediately available to client components
   // using the hooks.
-  prefetchModelsGetCount,
+  prefetchModelsListModelsCount,
   
   // Utility to invalidate the query cache for this query in response to
   // mutations and other user actions.
-  invalidateAllModelsGetCount,
-} from "@openrouter/sdk/react-query/modelsGetCount.js";
+  invalidateAllModelsListModelsCount,
+} from "@openrouter/sdk/react-query/modelsListModelsCount.js";
 ```
 
 ### Parameters
@@ -98,22 +98,21 @@ import {
 
 ### Response
 
-**Promise\<[operations.GetCountResponse](../../models/operations/getcountresponse.md)\>**
+**Promise\<[operations.ListModelsCountResponse](../../models/operations/listmodelscountresponse.md)\>**
 
 ### Errors
 
-| Error Type           | Status Code          | Content Type         |
-| -------------------- | -------------------- | -------------------- |
-| errors.ErrorResponse | 4XX                  | application/json     |
-| errors.ErrorResponse | 5XX                  | application/json     |
+| Error Type                    | Status Code                   | Content Type                  |
+| ----------------------------- | ----------------------------- | ----------------------------- |
+| errors.OpenRouterDefaultError | 4XX, 5XX                      | \*/\*                         |
 
-## list
+## getModels
 
 List all models and their properties
 
 ### Example Usage
 
-<!-- UsageSnippet language="typescript" operationID="listModels" method="get" path="/models" -->
+<!-- UsageSnippet language="typescript" operationID="getModels" method="get" path="/models" -->
 ```typescript
 import { OpenRouter } from "@openrouter/sdk";
 
@@ -122,7 +121,7 @@ const openRouter = new OpenRouter({
 });
 
 async function run() {
-  const result = await openRouter.models.list({
+  const result = await openRouter.models.getModels({
     category: "<value>",
     supportedParameters: "<value>",
     useRss: "<value>",
@@ -141,7 +140,7 @@ The standalone function version of this method:
 
 ```typescript
 import { OpenRouterCore } from "@openrouter/sdk/core.js";
-import { modelsList } from "@openrouter/sdk/funcs/modelsList.js";
+import { modelsGetModels } from "@openrouter/sdk/funcs/modelsGetModels.js";
 
 // Use `OpenRouterCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -150,7 +149,7 @@ const openRouter = new OpenRouterCore({
 });
 
 async function run() {
-  const res = await modelsList(openRouter, {
+  const res = await modelsGetModels(openRouter, {
     category: "<value>",
     supportedParameters: "<value>",
     useRss: "<value>",
@@ -160,7 +159,7 @@ async function run() {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("modelsList failed:", res.error);
+    console.log("modelsGetModels failed:", res.error);
   }
 }
 
@@ -180,55 +179,54 @@ associated utilities.
 ```tsx
 import {
   // Query hooks for fetching data.
-  useModelsList,
-  useModelsListSuspense,
+  useModelsGetModels,
+  useModelsGetModelsSuspense,
 
   // Utility for prefetching data during server-side rendering and in React
   // Server Components that will be immediately available to client components
   // using the hooks.
-  prefetchModelsList,
+  prefetchModelsGetModels,
   
   // Utilities to invalidate the query cache for this query in response to
   // mutations and other user actions.
-  invalidateModelsList,
-  invalidateAllModelsList,
-} from "@openrouter/sdk/react-query/modelsList.js";
+  invalidateModelsGetModels,
+  invalidateAllModelsGetModels,
+} from "@openrouter/sdk/react-query/modelsGetModels.js";
 ```
 
 ### Parameters
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.ListModelsRequest](../../models/operations/listmodelsrequest.md)                                                                                                   | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `request`                                                                                                                                                                      | [operations.GetModelsRequest](../../models/operations/getmodelsrequest.md)                                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
 
 ### Response
 
-**Promise\<[operations.ListModelsResponse](../../models/operations/listmodelsresponse.md)\>**
+**Promise\<[operations.GetModelsResponse](../../models/operations/getmodelsresponse.md)\>**
 
 ### Errors
 
-| Error Type           | Status Code          | Content Type         |
-| -------------------- | -------------------- | -------------------- |
-| errors.ErrorResponse | 4XX                  | application/json     |
-| errors.ErrorResponse | 5XX                  | application/json     |
+| Error Type                    | Status Code                   | Content Type                  |
+| ----------------------------- | ----------------------------- | ----------------------------- |
+| errors.OpenRouterDefaultError | 4XX, 5XX                      | \*/\*                         |
 
-## listUserModels
+## listModelsUser
 
 List models filtered by user provider preferences
 
 ### Example Usage
 
-<!-- UsageSnippet language="typescript" operationID="listUserModels" method="get" path="/models/user" -->
+<!-- UsageSnippet language="typescript" operationID="listModelsUser" method="get" path="/models/user" -->
 ```typescript
 import { OpenRouter } from "@openrouter/sdk";
 
 const openRouter = new OpenRouter();
 
 async function run() {
-  const result = await openRouter.models.listUserModels({
+  const result = await openRouter.models.listModelsUser({
     bearer: process.env["OPENROUTER_BEARER"] ?? "",
   });
 
@@ -244,21 +242,21 @@ The standalone function version of this method:
 
 ```typescript
 import { OpenRouterCore } from "@openrouter/sdk/core.js";
-import { modelsListUserModels } from "@openrouter/sdk/funcs/modelsListUserModels.js";
+import { modelsListModelsUser } from "@openrouter/sdk/funcs/modelsListModelsUser.js";
 
 // Use `OpenRouterCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const openRouter = new OpenRouterCore();
 
 async function run() {
-  const res = await modelsListUserModels(openRouter, {
+  const res = await modelsListModelsUser(openRouter, {
     bearer: process.env["OPENROUTER_BEARER"] ?? "",
   });
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("modelsListUserModels failed:", res.error);
+    console.log("modelsListModelsUser failed:", res.error);
   }
 }
 
@@ -278,36 +276,35 @@ associated utilities.
 ```tsx
 import {
   // Query hooks for fetching data.
-  useModelsListUserModels,
-  useModelsListUserModelsSuspense,
+  useModelsListModelsUser,
+  useModelsListModelsUserSuspense,
 
   // Utility for prefetching data during server-side rendering and in React
   // Server Components that will be immediately available to client components
   // using the hooks.
-  prefetchModelsListUserModels,
+  prefetchModelsListModelsUser,
   
   // Utility to invalidate the query cache for this query in response to
   // mutations and other user actions.
-  invalidateAllModelsListUserModels,
-} from "@openrouter/sdk/react-query/modelsListUserModels.js";
+  invalidateAllModelsListModelsUser,
+} from "@openrouter/sdk/react-query/modelsListModelsUser.js";
 ```
 
 ### Parameters
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `security`                                                                                                                                                                     | [operations.ListUserModelsSecurity](../../models/operations/listusermodelssecurity.md)                                                                                         | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
+| `security`                                                                                                                                                                     | [operations.ListModelsUserSecurity](../../models/operations/listmodelsusersecurity.md)                                                                                         | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
 
 ### Response
 
-**Promise\<[operations.ListUserModelsResponse](../../models/operations/listusermodelsresponse.md)\>**
+**Promise\<[operations.ListModelsUserResponse](../../models/operations/listmodelsuserresponse.md)\>**
 
 ### Errors
 
-| Error Type           | Status Code          | Content Type         |
-| -------------------- | -------------------- | -------------------- |
-| errors.ErrorResponse | 4XX                  | application/json     |
-| errors.ErrorResponse | 5XX                  | application/json     |
+| Error Type                    | Status Code                   | Content Type                  |
+| ----------------------------- | ----------------------------- | ----------------------------- |
+| errors.OpenRouterDefaultError | 4XX, 5XX                      | \*/\*                         |

package/docs/sdks/parameters/README.md

@@ -0,0 +1,116 @@
+# ParametersT
+(*parameters*)
+
+## Overview
+
+Parameters endpoints
+
+### Available Operations
+
+* [getParameters](#getparameters) - Get a model's supported parameters and data about which are most popular
+
+## getParameters
+
+Get a model's supported parameters and data about which are most popular
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="getParameters" method="get" path="/parameters/{author}/{slug}" -->
+```typescript
+import { OpenRouter } from "@openrouter/sdk";
+
+const openRouter = new OpenRouter();
+
+async function run() {
+  const result = await openRouter.parameters.getParameters({
+    bearer: process.env["OPENROUTER_BEARER"] ?? "",
+  }, {
+    author: "<value>",
+    slug: "<value>",
+    provider: "Google AI Studio",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { OpenRouterCore } from "@openrouter/sdk/core.js";
+import { parametersGetParameters } from "@openrouter/sdk/funcs/parametersGetParameters.js";
+
+// Use `OpenRouterCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const openRouter = new OpenRouterCore();
+
+async function run() {
+  const res = await parametersGetParameters(openRouter, {
+    bearer: process.env["OPENROUTER_BEARER"] ?? "",
+  }, {
+    author: "<value>",
+    slug: "<value>",
+    provider: "Google AI Studio",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("parametersGetParameters failed:", res.error);
+  }
+}
+
+run();
+```
+
+### React hooks and utilities
+
+This method can be used in React components through the following hooks and
+associated utilities.
+
+> Check out [this guide][hook-guide] for information about each of the utilities
+> below and how to get started using React hooks.
+
+[hook-guide]: ../../../REACT_QUERY.md
+
+```tsx
+import {
+  // Query hooks for fetching data.
+  useParametersGetParameters,
+  useParametersGetParametersSuspense,
+
+  // Utility for prefetching data during server-side rendering and in React
+  // Server Components that will be immediately available to client components
+  // using the hooks.
+  prefetchParametersGetParameters,
+  
+  // Utilities to invalidate the query cache for this query in response to
+  // mutations and other user actions.
+  invalidateParametersGetParameters,
+  invalidateAllParametersGetParameters,
+} from "@openrouter/sdk/react-query/parametersGetParameters.js";
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.GetParametersRequest](../../models/operations/getparametersrequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.GetParametersSecurity](../../models/operations/getparameterssecurity.md)                                                                                           | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[operations.GetParametersResponse](../../models/operations/getparametersresponse.md)\>**
+
+### Errors
+
+| Error Type                    | Status Code                   | Content Type                  |
+| ----------------------------- | ----------------------------- | ----------------------------- |
+| errors.OpenRouterDefaultError | 4XX, 5XX                      | \*/\*                         |

package/docs/sdks/providers/README.md

@@ -7,11 +7,11 @@ Provider information endpoints
 
 ### Available Operations
 
-* [list](#list) - List all available model providers
+* [list](#list) - List all providers
 
 ## list
 
-List all available model providers
+List all providers
 
 ### Example Usage