empty commit to trigger [run-tests] workflow

## Python SDK Changes:
* `open_router.benchmarks.get_benchmarks()`: **Added** * `open_router.datasets.get_benchmarks_artificial_analysis()`: **Deleted** **Breaking** ⚠️ * `open_router.datasets.get_benchmarks_design_arena()`: **Deleted** **Breaking** ⚠️ * `open_router.chat.send()`: `response` **Changed** * `open_router.embeddings.generate()`: `response.usage` **Changed** * `open_router.embeddings.list_models()`: `response.data.[].reasoning` **Added** * `open_router.models.get()`: `response.data.reasoning` **Added** * `open_router.models.list()`: `response.data.[].reasoning` **Added** * `open_router.models.list_for_user()`: `response.data.[].reasoning` **Added**
2026-07-31 12:30:30 +08:00 · 2026-06-22 16:37:39 +00:00 · 2026-06-22 16:37:22 +00:00 · 2026-06-22 12:32:12 -04:00 · 2026-06-22 11:59:27 -04:00 · 2026-06-22 11:20:24 -04:00
1187 changed files with 149748 additions and 25686 deletions
@@ -1,7 +1,9 @@
 {
  "permissions": {
    "allow": [
-      "Bash(python3:*)"
+      "Bash(python3:*)",
+      "Bash(git push:*)",
+      "Bash(gh pr create:*)"
    ],
    "deny": [],
    "ask": []
@@ -1,4 +1,9 @@

+<div align="center">
+    <a href="https://codespaces.new/OpenRouterTeam/python-sdk.git/tree/main"><img src="https://github.com/codespaces/badge.svg" /></a>
+</div>
+<br>
+
 > **Remember to shutdown a GitHub Codespace when it is not in use!**

 # Dev Containers Quick Start
@@ -0,0 +1,92 @@
+name: Auto-merge Speakeasy PR
+
+# Speakeasy mode:pr opens PRs (speakeasy-sdk-regen-*) and labels them
+# patch/minor/major. Merge automatically so sdk_publish.yaml can run.
+
+on:
+  pull_request:
+    types: [labeled, opened]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: auto-merge-speakeasy
+  cancel-in-progress: false
+
+jobs:
+  auto-merge:
+    if: |
+      github.event.sender.login == 'github-actions[bot]' &&
+      github.event.pull_request.user.login == 'github-actions[bot]' &&
+      startsWith(github.event.pull_request.head.ref, 'speakeasy-sdk-regen-') &&
+      contains(github.event.pull_request.title, '🐝 Update SDK') &&
+      (
+        (github.event.action == 'labeled' && contains(fromJSON('["patch", "minor", "major"]'), github.event.label.name)) ||
+        (github.event.action == 'opened' && 
+         (contains(github.event.pull_request.labels.*.name, 'patch') || 
+          contains(github.event.pull_request.labels.*.name, 'minor') || 
+          contains(github.event.pull_request.labels.*.name, 'major')))
+      )
+    runs-on: ubuntu-latest
+    steps:
+      - name: Close superseded Speakeasy PRs
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          CURRENT_PR="${{ github.event.pull_request.number }}"
+
+          PRIOR_JSON=$(gh pr list \
+            --repo "${{ github.repository }}" \
+            --state open \
+            --search "head:speakeasy-sdk-regen-" \
+            --limit 500 \
+            --json number \
+            | jq -r --arg cur "$CURRENT_PR" \
+              '[.[].number | select(tostring != $cur)] | .[]')
+
+          if [ -z "$PRIOR_JSON" ]; then
+            echo "No superseded Speakeasy PRs to close"
+            exit 0
+          fi
+
+          mapfile -t PRIOR <<< "$PRIOR_JSON"
+
+          echo "Closing ${#PRIOR[@]} superseded Speakeasy PR(s)"
+          for N in "${PRIOR[@]}"; do
+            gh pr close "$N" --repo "${{ github.repository }}" --delete-branch \
+              --comment "Superseded by newer Speakeasy SDK generation PR #${CURRENT_PR}" \
+              || echo "::warning::Failed to close PR #$N (continuing)"
+            sleep 1
+          done
+
+      - name: Auto-merge Speakeasy PR
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          PR_NUM="${{ github.event.pull_request.number }}"
+          REPO="${{ github.repository }}"
+
+          STATE=$(gh pr view "$PR_NUM" --repo "$REPO" --json state --jq .state)
+          if [ "$STATE" != "OPEN" ]; then
+            echo "PR #$PR_NUM is $STATE — skipping merge"
+            exit 0
+          fi
+
+          # Prefer GitHub auto-merge when required checks exist; otherwise
+          # squash-merge directly (same pattern as sdk-release-prs.yaml).
+          AUTO_MERGE_NOOP_PATTERN='is in clean status|protected branch rules|Branch does not have required protected branch rules'
+          if gh pr merge "$PR_NUM" --repo "$REPO" --squash --auto --delete-branch 2> /tmp/gh-merge.err; then
+            echo "Auto-merge enabled for Speakeasy PR #$PR_NUM"
+          elif grep -qiE "$AUTO_MERGE_NOOP_PATTERN" /tmp/gh-merge.err; then
+            echo "Auto-merge not applicable — merging PR #$PR_NUM directly"
+            cat /tmp/gh-merge.err >&2
+            gh pr merge "$PR_NUM" --repo "$REPO" --squash --delete-branch
+          else
+            echo "::error::Failed to enable auto-merge on Speakeasy PR #$PR_NUM"
+            cat /tmp/gh-merge.err >&2
+            exit 1
+          fi
@@ -0,0 +1,46 @@
+name: Notify Monorepo of Changes
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  notify-monorepo:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Send repository dispatch to monorepo
+        run: |
+          # Determine which event type to send based on repository name
+          REPO_NAME="${GITHUB_REPOSITORY#*/}"  # Gets 'python-sdk' from 'OpenRouterTeam/python-sdk'
+
+          case "$REPO_NAME" in
+            "typescript-sdk")
+              EVENT_TYPE="sync-typescript-sdk"
+              ;;
+            "python-sdk")
+              EVENT_TYPE="sync-python-sdk"
+              ;;
+            "ai-sdk-provider")
+              EVENT_TYPE="sync-ai-sdk-provider"
+              ;;
+            "cli")
+              EVENT_TYPE="sync-cli"
+              ;;
+            *)
+              echo "Unknown repository: $REPO_NAME"
+              exit 1
+              ;;
+          esac
+
+          echo "Sending repository_dispatch event: $EVENT_TYPE"
+
+          curl -L \
+            -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.MONOREPO_SYNC_TOKEN }}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/OpenRouterTeam/openrouter-web/dispatches \
+            -d "{\"event_type\":\"$EVENT_TYPE\",\"client_payload\":{\"repository\":\"$GITHUB_REPOSITORY\",\"ref\":\"$GITHUB_REF\",\"sha\":\"$GITHUB_SHA\"}}"
+
+          echo "✅ Notification sent to monorepo"
@@ -0,0 +1,36 @@
+name: Generate (spec change merged)
+permissions:
+  checks: write
+  contents: write
+  pull-requests: write
+  statuses: write
+  id-token: write
+"on":
+  workflow_dispatch:
+    inputs:
+      force:
+        description: Force generation of SDKs
+        type: boolean
+        default: false
+      set_version:
+        description: optionally set a specific SDK version
+        type: string
+  pull_request:
+    types: [closed]
+    branches:
+      - main
+    paths:
+      - .speakeasy/in.openapi.yaml
+
+jobs:
+  generate:
+    if: github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
+    uses: speakeasy-api/sdk-generation-action/.github/workflows/workflow-executor.yaml@v15
+    with:
+      force: ${{ github.event.inputs.force }}
+      mode: pr
+      set_version: ${{ github.event.inputs.set_version }}
+    secrets:
+      github_access_token: ${{ secrets.GITHUB_TOKEN }}
+      pypi_token: ${{ secrets.PYPI_TOKEN }}
+      speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
@@ -1,13 +1,25 @@
-.venv/
 venv/
 src/*.egg-info/
 **/__pycache__/
 .pytest_cache/
 .python-version
-.DS_Store
 pyrightconfig.json
 **/.speakeasy/temp/
 **/.speakeasy/logs/
 .speakeasy/reports
+# Build artifacts
+/dist
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+# Speakeasy generation artifacts (generated in OSS repo, not here)
+.speakeasy/*.lock
+.speakeasy/*.openapi.yaml
+/docs
+# Environment
 .env
 .env.local
+.env.*.local
+.DS_Store
+.venv/
@@ -6,7 +6,7 @@ generation:
  sdkClassName: OpenRouter
  maintainOpenAPIOrder: true
  usageSnippets:
-    optionalPropertyRendering: withExample
+    optionalPropertyRendering: never
    sdkInitStyle: constructor
  useClassNamesForArrayFields: true
  fixes:
@@ -24,13 +24,15 @@ generation:
  sdkHooksConfigAccess: true
  schemas:
    allOfMergeStrategy: shallowMerge
-  requestBodyFieldName: body
+  requestBodyFieldName: ""
+  persistentEdits: {}
  tests:
    generateTests: false
    generateNewTests: true
    skipResponseBodyAssertions: false
+  preApplyUnionDiscriminators: true
 python:
-  version: 0.0.15
+  version: 0.10.1
  additionalDependencies:
    dev: {}
    main: {}
@@ -38,11 +40,14 @@ python:
    - id
    - object
    - input
+    - models
+    - hash
  asyncMode: both
  authors:
    - OpenRouter
  baseErrorName: OpenRouterError
  clientServerStatusCodesAsErrors: true
+  constFieldCasing: upper
  defaultErrorName: OpenRouterDefaultError
  description: Official Python Client SDK for OpenRouter.
  enableCustomCodeRegions: false
@@ -54,22 +59,28 @@ python:
  flattenGlobalSecurity: true
  flattenRequests: true
  flatteningOrder: parameters-first
+  forwardCompatibleUnionsByDefault: tagged-only
  imports:
    option: openapi
    paths:
-      callbacks: ""
+      callbacks: callbacks
      errors: errors
      operations: operations
      shared: components
-      webhooks: ""
+      webhooks: webhooks
+  inferSSEOverload: true
+  inferUnionDiscriminators: true
  inputModelSuffix: input
  legacyPyright: false
+  license: Apache-2.0
  maxMethodParams: 999
  methodArguments: infer-optional-args
  moduleName: ""
+  multipartArrayFormat: legacy
  outputModelSuffix: output
  packageManager: uv
  packageName: openrouter
+  preApplyUnionDiscriminators: false
  pytestFilterWarnings: []
  pytestTimeout: 0
  responseFormat: flat
@@ -0,0 +1,10 @@
+lintVersion: 1.0.0
+defaultRuleset: openrouter
+rulesets:
+  openrouter:
+    rulesets:
+      - speakeasy-recommended
+      - speakeasy-generation
+    rules:
+      oas3-missing-example:
+        severity: "off"
@@ -0,0 +1,52 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Add HTTP-Referer and X-OpenRouter-Title as global parameters
+  version: 0.0.0
+actions:
+  # Add global parameters for app identification
+  - target: $
+    description: Add x-speakeasy-globals for HTTP-Referer, X-OpenRouter-Title, and X-OpenRouter-Categories headers
+    update:
+      x-speakeasy-globals:
+        parameters:
+          - $ref: "#/components/parameters/AppIdentifier"
+          - $ref: "#/components/parameters/AppDisplayName"
+          - $ref: "#/components/parameters/AppCategories"
+
+  # Add component parameters
+  - target: $.components
+    description: Add parameters for app identification headers
+    update:
+      parameters:
+        AppIdentifier:
+          name: HTTP-Referer
+          in: header
+          schema:
+            type: string
+          description: |
+            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.
+        AppDisplayName:
+          name: X-OpenRouter-Title
+          in: header
+          schema:
+            type: string
+          description: |
+            The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+        AppCategories:
+          name: X-OpenRouter-Categories
+          in: header
+          schema:
+            type: string
+          description: |
+            Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+
+  # Add header parameters to all paths so Speakeasy matches them with globals
+  - target: $.paths[*]
+    description: Reference app identification headers on all paths so Speakeasy injects them via globals
+    update:
+      parameters:
+        - $ref: "#/components/parameters/AppIdentifier"
+        - $ref: "#/components/parameters/AppDisplayName"
+        - $ref: "#/components/parameters/AppCategories"
@@ -0,0 +1,11 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Simplify redundant allOf inline schemas
+  version: 0.0.0
+actions:
+  - target: "$..allOf[?@.enum && !@['$ref']]"
+    description: >
+      Remove inline enum definitions that duplicate a $ref enum in the same
+      allOf. These are artifacts from zod-openapi .extend() serialization.
+    remove: true
@@ -0,0 +1,10 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Convert boolean query params from string to boolean
+  version: 0.0.0
+actions:
+  - target: $..parameters[?@.schema["x-openrouter-type"] == "boolean"].schema
+    description: Convert x-openrouter-type boolean params from string to boolean
+    update:
+      type: boolean
@@ -0,0 +1,10 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Fix nullable pagination params
+  version: 0.0.0
+actions:
+  - target: $..parameters[?@.name == "offset" && @.in == "query"].schema
+    description: Remove nullable from offset query params to fix mypy errors in pagination helpers
+    update:
+      nullable: false
@@ -0,0 +1,10 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Add open enums
+  version: 0.0.0
+actions:
+  - target: $..[?length(@.enum) > 1]
+    description: Automatically open all enums that have length > 1
+    update:
+      x-speakeasy-unknown-values: allow
@@ -0,0 +1,15 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Remove RSS+XML response schemas and related parameters
+  version: 0.0.0
+actions:
+  - target: $..responses.*.content["application/rss+xml"]
+    description: Remove application/rss+xml response schemas
+    remove: true
+  - target: $..parameters[?@.name == "use_rss"]
+    description: Remove use_rss parameter
+    remove: true
+  - target: $..parameters[?@.name == "use_rss_chat_links"]
+    description: Remove use_rss_chat_links parameter
+    remove: true
@@ -1,37 +1,48 @@
-speakeasyVersion: 1.656.2
+speakeasyVersion: 1.680.0
 sources:
-    -OAS:
+    OpenRouter API:
        sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:08647b466c00989914e3a2436175152270f771f0a57d055f5bab14cc2d4be89e
-        sourceBlobDigest: sha256:53027ec57392d9617cc001ece83c2fe1aa6e5dbfd52d170381c34c33c6042c23
+        sourceRevisionDigest: sha256:e723fd6d93d1675f10180ae0294e31a5f58f3492260b2afb840c9d21afe73fa5
+        sourceBlobDigest: sha256:e0cae9ca4d8bd6326bf2af1bc0b1444b9819a634698e848acf6831bcd7391c36
        tags:
            - latest
+            - speakeasy-sdk-regen-1782146156
+            - 1.0.0
 targets:
    open-router:
-        source: -OAS
+        source: OpenRouter API
        sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:08647b466c00989914e3a2436175152270f771f0a57d055f5bab14cc2d4be89e
-        sourceBlobDigest: sha256:53027ec57392d9617cc001ece83c2fe1aa6e5dbfd52d170381c34c33c6042c23
+        sourceRevisionDigest: sha256:e723fd6d93d1675f10180ae0294e31a5f58f3492260b2afb840c9d21afe73fa5
+        sourceBlobDigest: sha256:e0cae9ca4d8bd6326bf2af1bc0b1444b9819a634698e848acf6831bcd7391c36
+        codeSamplesNamespace: open-router-python-code-samples
+        codeSamplesRevisionDigest: sha256:18d9a2a331754321fc8bb0067e344794777799ec325b28bdd67548c0d0f3bbe1
 workflow:
    workflowVersion: 1.0.0
-    speakeasyVersion: latest
+    speakeasyVersion: 1.680.0
    sources:
-        -OAS:
+        OpenRouter API:
            inputs:
-                - location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api:main
+                - location: .speakeasy/in.openapi.yaml
+            overlays:
+                - location: .speakeasy/overlays/open-enums.overlay.yaml
+                - location: .speakeasy/overlays/remove-rss-responses.overlay.yaml
+                - location: .speakeasy/overlays/add-headers.overlay.yaml
+                - location: .speakeasy/overlays/allof-simplify.overlay.yaml
+                - location: .speakeasy/overlays/boolean-query-params.overlay.yaml
+                - location: .speakeasy/overlays/fix-nullable-pagination.overlay.yaml
            output: .speakeasy/out.openapi.yaml
            registry:
-                location: registry.speakeasyapi.dev/openrouter/sdk/-oas
+                location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api
    targets:
        open-router:
            target: python
-            source: -OAS
+            source: OpenRouter API
            publish:
                pypi:
                    token: $pypi_token
            codeSamples:
                registry:
-                    location: registry.speakeasyapi.dev/openrouter/sdk/-oas-python-code-samples
+                    location: registry.speakeasyapi.dev/openrouter/sdk/open-router-python-code-samples
                labelOverride:
                    fixedValue: Python (SDK)
                blocking: false
@@ -1,22 +1,29 @@
 workflowVersion: 1.0.0
-speakeasyVersion: latest
+speakeasyVersion: 1.680.0
 sources:
-    -OAS:
+    OpenRouter API:
        inputs:
-            - location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api:main
+            - location: .speakeasy/in.openapi.yaml
+        overlays:
+            - location: .speakeasy/overlays/open-enums.overlay.yaml
+            - location: .speakeasy/overlays/remove-rss-responses.overlay.yaml
+            - location: .speakeasy/overlays/add-headers.overlay.yaml
+            - location: .speakeasy/overlays/allof-simplify.overlay.yaml
+            - location: .speakeasy/overlays/boolean-query-params.overlay.yaml
+            - location: .speakeasy/overlays/fix-nullable-pagination.overlay.yaml
        output: .speakeasy/out.openapi.yaml
        registry:
-            location: registry.speakeasyapi.dev/openrouter/sdk/-oas
+            location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api
 targets:
    open-router:
        target: python
-        source: -OAS
+        source: OpenRouter API
        publish:
            pypi:
                token: $pypi_token
        codeSamples:
            registry:
-                location: registry.speakeasyapi.dev/openrouter/sdk/-oas-python-code-samples
+                location: registry.speakeasyapi.dev/openrouter/sdk/open-router-python-code-samples
            labelOverride:
                fixedValue: Python (SDK)
            blocking: false
@@ -1,6 +1,6 @@
 # OpenRouter Python SDK

-The OpenRouter Python SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.
+The OpenRouter Python SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.

 ## Why use the OpenRouter SDK?

@@ -0,0 +1,312 @@
+# OpenRouter SDK
+
+The [OpenRouter SDK](https://openrouter.ai/docs/sdks/python) is a Python toolkit designed to help you build AI-powered features and solutions. Giving you easy access to 400+ models across providers in an easy and type-safe way.
+
+To learn more about how to use the OpenRouter SDK, check out our [API Reference](https://openrouter.ai/docs/sdks/python/reference) and [Documentation](https://openrouter.ai/docs/sdks/python).
+
+<!-- No Summary [summary] -->
+
+<!-- No Table of Contents [toc] -->
+
+<!-- Start SDK Installation [installation] -->
+## SDK Installation
+
+> [!NOTE]
+> **Python version upgrade policy**
+>
+> Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
+
+The SDK can be installed with *uv*, *pip*, or *poetry* package managers.
+
+### uv
+
+*uv* is a fast Python package installer and resolver, designed as a drop-in replacement for pip and pip-tools. It's recommended for its speed and modern Python tooling capabilities.
+
+```bash
+uv add openrouter
+```
+
+### PIP
+
+*PIP* is the default package installer for Python, enabling easy installation and management of packages from PyPI via the command line.
+
+```bash
+pip install openrouter
+```
+
+### Poetry
+
+*Poetry* is a modern tool that simplifies dependency management and package publishing by using a single `pyproject.toml` file to handle project metadata and dependencies.
+
+```bash
+poetry add openrouter
+```
+
+### Shell and script usage with `uv`
+
+You can use this SDK in a Python shell with [uv](https://docs.astral.sh/uv/) and the `uvx` command that comes with it like so:
+
+```shell
+uvx --from openrouter python
+```
+
+It's also possible to write a standalone Python script without needing to set up a whole project like so:
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.9"
+# dependencies = [
+#     "openrouter",
+# ]
+# ///
+
+from openrouter import OpenRouter
+
+sdk = OpenRouter(
+  # SDK arguments
+)
+
+# Rest of script here...
+```
+
+Once that is saved to a file, you can run it with `uv run script.py` where
+`script.py` can be replaced with the actual file name.
+<!-- End SDK Installation [installation] -->
+
+<!-- Start Requirements [requirements] -->
+## Requirements
+
+This SDK requires Python 3.9 or higher. For Python version support policy, see the SDK Installation section above.
+<!-- End Requirements [requirements] -->
+
+<!-- Start IDE Support [idesupport] -->
+## IDE Support
+
+### PyCharm
+
+Generally, the SDK will work well with most IDEs out of the box. However, when using PyCharm, you can enjoy much better integration with Pydantic by installing an additional plugin.
+
+- [PyCharm Pydantic Plugin](https://docs.pydantic.dev/latest/integrations/pycharm/)
+<!-- End IDE Support [idesupport] -->
+
+<!-- No SDK Example Usage [usage] -->
+## SDK Usage
+
+```python
+# Synchronous Example
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.chat.send(messages=[
+        {
+            "role": "user",
+            "content": "Hello, how are you?",
+        },
+    ], model="anthropic/claude-4.5-sonnet", provider={
+        "zdr": True,
+        "sort": "price",
+    }, stream=True)
+
+    for event in event_stream:
+        # handle event
+        print(event, flush=True)
+```
+
+</br>
+
+The same SDK client can also be used to make asynchronous requests by importing asyncio.
+
+```python
+# Asynchronous Example
+import asyncio
+from openrouter import OpenRouter
+import os
+
+async def main():
+
+    async with OpenRouter(
+        api_key=os.getenv("OPENROUTER_API_KEY", ""),
+    ) as open_router:
+
+        res = await open_router.chat.send_async(messages=[
+        {
+            "role": "user",
+            "content": "Hello, how are you?",
+        },
+    ], model="anthropic/claude-4.5-sonnet", provider={
+        "zdr": True,
+        "sort": "price",
+    }, stream=True)
+
+        async for event in event_stream:
+            # handle event
+            print(event, flush=True)
+
+asyncio.run(main())
+```
+
+<!-- No Authentication [security] -->
+
+<!-- No Available Resources and Operations [operations] -->
+
+<!-- No Standalone functions [standalone-funcs] -->
+
+<!-- No React hooks with TanStack Query [react-query] -->
+
+<!-- No Server-sent event streaming [eventstream] -->
+
+<!-- No Retries [retries] -->
+
+<!-- No Error Handling [errors] -->
+
+<!-- No Server Selection [server] -->
+
+<!-- No Custom HTTP Client [http-client] -->
+
+<!-- Start Pagination [pagination] -->
+## Pagination
+
+Some of the endpoints in this SDK support pagination. To use pagination, you make your SDK calls as usual, but the
+returned response object will have a `Next` method that can be called to pull down the next group of results. If the
+return value of `Next` is `None`, then there are no more pages to be fetched.
+
+Here's an example of one such pagination call:
+```python
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    http_referer="<value>",
+    x_open_router_title="<value>",
+    x_open_router_categories="<value>",
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.byok.list()
+
+    while res is not None:
+        # Handle items
+
+        res = res.next()
+
+```
+<!-- End Pagination [pagination] -->
+
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept file objects as part of a request body or multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> For endpoints that handle file uploads bytes arrays can also be used. However, using streams is recommended for large files.
+>
+
+```python
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    http_referer="<value>",
+    x_open_router_title="<value>",
+    x_open_router_categories="<value>",
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.files.upload(file={
+        "file_name": "example.file",
+        "content": open("example.file", "rb"),
+    })
+
+    # Handle response
+    print(res)
+
+```
+<!-- End File uploads [file-upload] -->
+
+<!-- Start Resource Management [resource-management] -->
+## Resource Management
+
+The `OpenRouter` class implements the context manager protocol and registers a finalizer function to close the underlying sync and async HTTPX clients it uses under the hood. This will close HTTP connections, release memory and free up other resources held by the SDK. In short-lived Python programs and notebooks that make a few SDK method calls, resource management may not be a concern. However, in longer-lived programs, it is beneficial to create a single SDK instance via a [context manager][context-manager] and reuse it across the application.
+
+[context-manager]: https://docs.python.org/3/reference/datamodel.html#context-managers
+
+```python
+from openrouter import OpenRouter
+import os
+def main():
+
+    with OpenRouter(
+        http_referer="<value>",
+        x_open_router_title="<value>",
+        x_open_router_categories="<value>",
+        api_key=os.getenv("OPENROUTER_API_KEY", ""),
+    ) as open_router:
+        # Rest of application here...
+
+
+# Or when using async:
+async def amain():
+
+    async with OpenRouter(
+        http_referer="<value>",
+        x_open_router_title="<value>",
+        x_open_router_categories="<value>",
+        api_key=os.getenv("OPENROUTER_API_KEY", ""),
+    ) as open_router:
+        # Rest of application here...
+```
+<!-- End Resource Management [resource-management] -->
+
+<!-- Start Debugging [debug] -->
+## Debugging
+
+You can setup your SDK to emit debug logs for SDK requests and responses.
+
+You can pass your own logger class directly into your SDK.
+```python
+from openrouter import OpenRouter
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+s = OpenRouter(debug_logger=logging.getLogger("openrouter"))
+```
+
+You can also enable a default debug logger by setting an environment variable `OPENROUTER_DEBUG` to true.
+<!-- End Debugging [debug] -->
+
+<!-- Placeholder for Future Speakeasy SDK Sections -->
+
+# Development
+
+## Running Tests
+
+To run the test suite, you'll need to set up your environment with an OpenRouter API key.
+
+### Local Development
+
+1. Copy the example environment file:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+2. Edit `.env` and add your OpenRouter API key:
+
+   ```bash
+   OPENROUTER_API_KEY=your_api_key_here
+   ```
+
+3. Run the tests:
+
+   ```bash
+   pytest
+   ```
@@ -1,6 +1,6 @@
-# OpenRouter SDK (Beta)
+# OpenRouter SDK

-The [OpenRouter SDK](https://openrouter.ai/docs/sdks/python) is a Python toolkit designed to help you build AI-powered features and solutions. Giving you easy access to over 300 models across providers in an easy and type-safe way.
+The [OpenRouter SDK](https://openrouter.ai/docs/sdks/python) is a Python toolkit designed to help you build AI-powered features and solutions. Giving you easy access to 400+ models across providers in an easy and type-safe way.

 To learn more about how to use the OpenRouter SDK, check out our [API Reference](https://openrouter.ai/docs/sdks/python/reference) and [Documentation](https://openrouter.ai/docs/sdks/python).

@@ -169,6 +169,69 @@ asyncio.run(main())

 <!-- No Custom HTTP Client [http-client] -->

+<!-- Start Pagination [pagination] -->
+## Pagination
+
+Some of the endpoints in this SDK support pagination. To use pagination, you make your SDK calls as usual, but the
+returned response object will have a `Next` method that can be called to pull down the next group of results. If the
+return value of `Next` is `None`, then there are no more pages to be fetched.
+
+Here's an example of one such pagination call:
+```python
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    http_referer="<value>",
+    x_open_router_title="<value>",
+    x_open_router_categories="<value>",
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.byok.list()
+
+    while res is not None:
+        # Handle items
+
+        res = res.next()
+
+```
+<!-- End Pagination [pagination] -->
+
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept file objects as part of a request body or multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> For endpoints that handle file uploads bytes arrays can also be used. However, using streams is recommended for large files.
+>
+
+```python
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    http_referer="<value>",
+    x_open_router_title="<value>",
+    x_open_router_categories="<value>",
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.files.upload(file={
+        "file_name": "example.file",
+        "content": open("example.file", "rb"),
+    })
+
+    # Handle response
+    print(res)
+
+```
+<!-- End File uploads [file-upload] -->
+
 <!-- Start Resource Management [resource-management] -->
 ## Resource Management

@@ -182,6 +245,9 @@ import os
 def main():

    with OpenRouter(
+        http_referer="<value>",
+        x_open_router_title="<value>",
+        x_open_router_categories="<value>",
        api_key=os.getenv("OPENROUTER_API_KEY", ""),
    ) as open_router:
        # Rest of application here...
@@ -191,6 +257,9 @@ def main():
 async def amain():

    async with OpenRouter(
+        http_referer="<value>",
+        x_open_router_title="<value>",
+        x_open_router_categories="<value>",
        api_key=os.getenv("OPENROUTER_API_KEY", ""),
    ) as open_router:
        # Rest of application here...
@@ -240,10 +309,4 @@ To run the test suite, you'll need to set up your environment with an OpenRouter

   ```bash
   pytest
-   ```
-
-## Maturity
-
-This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage
-to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally
-looking for the latest version. 
+   ```
@@ -0,0 +1,41 @@
+
+
+## 2025-11-15 18:16:18
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.658.1 (2.755.6) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.0.16] .
+### Releases
+- [PyPI v0.0.16] https://pypi.org/project/openrouter/0.0.16 - .
+
+## 2026-06-11 00:55:55
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.9.2] .
+### Releases
+- [PyPI v0.9.2] https://pypi.org/project/openrouter/0.9.2 - .
+
+## 2026-06-17 00:59:07
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.0] .
+### Releases
+- [PyPI v0.10.0] https://pypi.org/project/openrouter/0.10.0 - .
+
+## 2026-06-22 16:35:38
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.1] .
+### Releases
+- [PyPI v0.10.1] https://pypi.org/project/openrouter/0.10.1 - .
@@ -6,69 +6,16 @@ import os


 with OpenRouter(
+    http_referer="<value>",
+    x_open_router_title="<value>",
+    x_open_router_categories="<value>",
    api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:

-    res = open_router.beta.responses.send(input=[
-        {
-            "type": "message",
-            "role": "user",
-            "content": "Hello, how are you?",
-        },
-    ], metadata={
-        "user_id": "123",
-        "session_id": "abc-def-ghi",
-    }, tools=[
-        {
-            "type": "function",
-            "name": "get_current_weather",
-            "description": "Get the current weather in a given location",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "location": {
-                        "type": "string",
-                    },
-                },
-            },
-        },
-    ], model="anthropic/claude-4.5-sonnet-20250929", text={
-        "format_": {
-            "type": "text",
-        },
-        "verbosity": "medium",
-    }, reasoning={
-        "summary": "auto",
-        "enabled": True,
-    }, temperature=0.7, top_p=0.9, prompt={
-        "id": "<id>",
-        "variables": {
-            "key": {
-                "type": "input_text",
-                "text": "Hello, how can I help you?",
-            },
-        },
-    }, service_tier="auto", truncation="auto", stream=False, provider={
-        "data_collection": "deny",
-        "zdr": True,
-        "enforce_distillable_text": True,
-        "order": [
-            "OpenAI",
-        ],
-        "only": [
-            "OpenAI",
-        ],
-        "ignore": [
-            "OpenAI",
-        ],
-        "quantizations": None,
-        "sort": "price",
-    })
+    res = open_router.analytics.get_user_activity()

-    with res as event_stream:
-        for event in event_stream:
-            # handle event
-            print(event, flush=True)
+    # Handle response
+    print(res)
 ```

 </br>
@@ -84,69 +31,16 @@ import os
 async def main():

    async with OpenRouter(
+        http_referer="<value>",
+        x_open_router_title="<value>",
+        x_open_router_categories="<value>",
        api_key=os.getenv("OPENROUTER_API_KEY", ""),
    ) as open_router:

-        res = await open_router.beta.responses.send_async(input=[
-            {
-                "type": "message",
-                "role": "user",
-                "content": "Hello, how are you?",
-            },
-        ], metadata={
-            "user_id": "123",
-            "session_id": "abc-def-ghi",
-        }, tools=[
-            {
-                "type": "function",
-                "name": "get_current_weather",
-                "description": "Get the current weather in a given location",
-                "parameters": {
-                    "type": "object",
-                    "properties": {
-                        "location": {
-                            "type": "string",
-                        },
-                    },
-                },
-            },
-        ], model="anthropic/claude-4.5-sonnet-20250929", text={
-            "format_": {
-                "type": "text",
-            },
-            "verbosity": "medium",
-        }, reasoning={
-            "summary": "auto",
-            "enabled": True,
-        }, temperature=0.7, top_p=0.9, prompt={
-            "id": "<id>",
-            "variables": {
-                "key": {
-                    "type": "input_text",
-                    "text": "Hello, how can I help you?",
-                },
-            },
-        }, service_tier="auto", truncation="auto", stream=False, provider={
-            "data_collection": "deny",
-            "zdr": True,
-            "enforce_distillable_text": True,
-            "order": [
-                "OpenAI",
-            ],
-            "only": [
-                "OpenAI",
-            ],
-            "ignore": [
-                "OpenAI",
-            ],
-            "quantizations": None,
-            "sort": "price",
-        })
+        res = await open_router.analytics.get_user_activity_async()

-        async with res as event_stream:
-            async for event in event_stream:
-                # handle event
-                print(event, flush=True)
+        # Handle response
+        print(res)

 asyncio.run(main())
 ```
@@ -5,14 +5,14 @@

 | Field                                               | Type                                                | Required                                            | Description                                         | Example                                             |
 | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- |
+| `byok_usage_inference`                              | *float*                                             | :heavy_check_mark:                                  | BYOK inference cost in USD (external credits spent) | 0.012                                               |
+| `completion_tokens`                                 | *int*                                               | :heavy_check_mark:                                  | Total completion tokens generated                   | 125                                                 |
 | `date_`                                             | *str*                                               | :heavy_check_mark:                                  | Date of the activity (YYYY-MM-DD format)            | 2025-08-24                                          |
+| `endpoint_id`                                       | *str*                                               | :heavy_check_mark:                                  | Unique identifier for the endpoint                  | 550e8400-e29b-41d4-a716-446655440000                |
 | `model`                                             | *str*                                               | :heavy_check_mark:                                  | Model slug (e.g., "openai/gpt-4.1")                 | openai/gpt-4.1                                      |
 | `model_permaslug`                                   | *str*                                               | :heavy_check_mark:                                  | Model permaslug (e.g., "openai/gpt-4.1-2025-04-14") | openai/gpt-4.1-2025-04-14                           |
-| `endpoint_id`                                       | *str*                                               | :heavy_check_mark:                                  | Unique identifier for the endpoint                  | 550e8400-e29b-41d4-a716-446655440000                |
+| `prompt_tokens`                                     | *int*                                               | :heavy_check_mark:                                  | Total prompt tokens used                            | 50                                                  |
 | `provider_name`                                     | *str*                                               | :heavy_check_mark:                                  | Name of the provider serving this endpoint          | OpenAI                                              |
-| `usage`                                             | *float*                                             | :heavy_check_mark:                                  | Total cost in USD (OpenRouter credits spent)        | 0.015                                               |
-| `byok_usage_inference`                              | *float*                                             | :heavy_check_mark:                                  | BYOK inference cost in USD (external credits spent) | 0.012                                               |
-| `requests`                                          | *float*                                             | :heavy_check_mark:                                  | Number of requests made                             | 5                                                   |
-| `prompt_tokens`                                     | *float*                                             | :heavy_check_mark:                                  | Total prompt tokens used                            | 50                                                  |
-| `completion_tokens`                                 | *float*                                             | :heavy_check_mark:                                  | Total completion tokens generated                   | 125                                                 |
-| `reasoning_tokens`                                  | *float*                                             | :heavy_check_mark:                                  | Total reasoning tokens used                         | 25                                                  |
+| `reasoning_tokens`                                  | *int*                                               | :heavy_check_mark:                                  | Total reasoning tokens used                         | 25                                                  |
+| `requests`                                          | *int*                                               | :heavy_check_mark:                                  | Number of requests made                             | 5                                                   |
+| `usage`                                             | *float*                                             | :heavy_check_mark:                                  | Total cost in USD (OpenRouter credits spent)        | 0.015                                               |
@@ -7,8 +7,8 @@ Model architecture information

 | Field                                                              | Type                                                               | Required                                                           | Description                                                        | Example                                                            |
 | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ |
-| `tokenizer`                                                        | [Nullable[components.Tokenizer]](../components/tokenizer.md)       | :heavy_check_mark:                                                 | N/A                                                                | GPT                                                                |
-| `instruct_type`                                                    | [Nullable[components.InstructType]](../components/instructtype.md) | :heavy_check_mark:                                                 | Instruction format type                                            |                                                                    |
-| `modality`                                                         | *Nullable[str]*                                                    | :heavy_check_mark:                                                 | Primary modality of the model                                      | text                                                               |
 | `input_modalities`                                                 | List[[components.InputModality](../components/inputmodality.md)]   | :heavy_check_mark:                                                 | Supported input modalities                                         |                                                                    |
-| `output_modalities`                                                | List[[components.OutputModality](../components/outputmodality.md)] | :heavy_check_mark:                                                 | Supported output modalities                                        |                                                                    |
+| `instruct_type`                                                    | [Nullable[components.InstructType]](../components/instructtype.md) | :heavy_check_mark:                                                 | Instruction format type                                            | chatml                                                             |
+| `modality`                                                         | *Nullable[str]*                                                    | :heavy_check_mark:                                                 | Primary modality of the model                                      | text                                                               |
+| `output_modalities`                                                | List[[components.OutputModality](../components/outputmodality.md)] | :heavy_check_mark:                                                 | Supported output modalities                                        |                                                                    |
+| `tokenizer`                                                        | [Nullable[components.Tokenizer]](../components/tokenizer.md)       | :heavy_check_mark:                                                 | N/A                                                                | GPT                                                                |
@@ -1,13 +0,0 @@
-# AssistantMessage
-
-
-## Fields
-
-| Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      |
-| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
-| `role`                                                                                           | *Literal["assistant"]*                                                                           | :heavy_check_mark:                                                                               | N/A                                                                                              |
-| `content`                                                                                        | [OptionalNullable[components.AssistantMessageContent]](../components/assistantmessagecontent.md) | :heavy_minus_sign:                                                                               | N/A                                                                                              |
-| `name`                                                                                           | *Optional[str]*                                                                                  | :heavy_minus_sign:                                                                               | N/A                                                                                              |
-| `tool_calls`                                                                                     | List[[components.ChatMessageToolCall](../components/chatmessagetoolcall.md)]                     | :heavy_minus_sign:                                                                               | N/A                                                                                              |
-| `refusal`                                                                                        | *OptionalNullable[str]*                                                                          | :heavy_minus_sign:                                                                               | N/A                                                                                              |
-| `reasoning`                                                                                      | *OptionalNullable[str]*                                                                          | :heavy_minus_sign:                                                                               | N/A                                                                                              |
@@ -1,17 +0,0 @@
-# AssistantMessageContent
-
-
-## Supported Types
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
-### `List[components.ChatMessageContentItem]`
-
-```python
-value: List[components.ChatMessageContentItem] = /* values here */
-```
-
@@ -0,0 +1,13 @@
+# By
+
+The provider sorting strategy (price, throughput, latency)
+
+
+## Values
+
+| Name         | Value        |
+| ------------ | ------------ |
+| `PRICE`      | price        |
+| `THROUGHPUT` | throughput   |
+| `LATENCY`    | latency      |
+| `EXACTO`     | exacto       |
@@ -1,10 +0,0 @@
-# ChainID
-
-
-## Values
-
-| Name                                          | Value                                         |
-| --------------------------------------------- | --------------------------------------------- |
-| `ONE`                                         | 1                                             |
-| `ONE_HUNDRED_AND_THIRTY_SEVEN`                | 137                                           |
-| `EIGHT_THOUSAND_FOUR_HUNDRED_AND_FIFTY_THREE` | 8453                                          |
@@ -1,12 +0,0 @@
-# ChatCompletionFinishReason
-
-
-## Values
-
-| Name             | Value            |
-| ---------------- | ---------------- |
-| `TOOL_CALLS`     | tool_calls       |
-| `STOP`           | stop             |
-| `LENGTH`         | length           |
-| `CONTENT_FILTER` | content_filter   |
-| `ERROR`          | error            |
@@ -1,11 +0,0 @@
-# ChatErrorError
-
-
-## Fields
-
-| Field                                              | Type                                               | Required                                           | Description                                        |
-| -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- |
-| `code`                                             | [Nullable[components.Code]](../components/code.md) | :heavy_check_mark:                                 | N/A                                                |
-| `message`                                          | *str*                                              | :heavy_check_mark:                                 | N/A                                                |
-| `param`                                            | *OptionalNullable[str]*                            | :heavy_minus_sign:                                 | N/A                                                |
-| `type`                                             | *OptionalNullable[str]*                            | :heavy_minus_sign:                                 | N/A                                                |
@@ -1,29 +0,0 @@
-# ChatGenerationParams
-
-
-## Fields
-
-| Field                                                                                                                    | Type                                                                                                                     | Required                                                                                                                 | Description                                                                                                              |
-| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `messages`                                                                                                               | List[[components.Message](../components/message.md)]                                                                     | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |
-| `model`                                                                                                                  | *Optional[str]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `models`                                                                                                                 | List[*str*]                                                                                                              | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `frequency_penalty`                                                                                                      | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `logit_bias`                                                                                                             | Dict[str, *float*]                                                                                                       | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `logprobs`                                                                                                               | *OptionalNullable[bool]*                                                                                                 | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `top_logprobs`                                                                                                           | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `max_completion_tokens`                                                                                                  | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `max_tokens`                                                                                                             | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `metadata`                                                                                                               | Dict[str, *str*]                                                                                                         | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `presence_penalty`                                                                                                       | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `reasoning`                                                                                                              | [Optional[components.Reasoning]](../components/reasoning.md)                                                             | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `response_format`                                                                                                        | [Optional[components.ChatGenerationParamsResponseFormatUnion]](../components/chatgenerationparamsresponseformatunion.md) | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `seed`                                                                                                                   | *OptionalNullable[int]*                                                                                                  | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `stop`                                                                                                                   | [OptionalNullable[components.ChatGenerationParamsStop]](../components/chatgenerationparamsstop.md)                       | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `stream`                                                                                                                 | *Optional[bool]*                                                                                                         | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `stream_options`                                                                                                         | [OptionalNullable[components.ChatStreamOptions]](../components/chatstreamoptions.md)                                     | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `temperature`                                                                                                            | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `tool_choice`                                                                                                            | *Optional[Any]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `tools`                                                                                                                  | List[[components.ToolDefinitionJSON](../components/tooldefinitionjson.md)]                                               | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `top_p`                                                                                                                  | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
-| `user`                                                                                                                   | *Optional[str]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
@@ -1,8 +0,0 @@
-# ChatGenerationParamsResponseFormatJSONObject
-
-
-## Fields
-
-| Field                    | Type                     | Required                 | Description              |
-| ------------------------ | ------------------------ | ------------------------ | ------------------------ |
-| `type`                   | *Literal["json_object"]* | :heavy_check_mark:       | N/A                      |
@@ -1,8 +0,0 @@
-# ChatGenerationParamsResponseFormatPython
-
-
-## Fields
-
-| Field               | Type                | Required            | Description         |
-| ------------------- | ------------------- | ------------------- | ------------------- |
-| `type`              | *Literal["python"]* | :heavy_check_mark:  | N/A                 |
@@ -1,8 +0,0 @@
-# ChatGenerationParamsResponseFormatText
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `type`             | *Literal["text"]*  | :heavy_check_mark: | N/A                |
@@ -1,35 +0,0 @@
-# ChatGenerationParamsResponseFormatUnion
-
-
-## Supported Types
-
-### `components.ChatGenerationParamsResponseFormatText`
-
-```python
-value: components.ChatGenerationParamsResponseFormatText = /* values here */
-```
-
-### `components.ChatGenerationParamsResponseFormatJSONObject`
-
-```python
-value: components.ChatGenerationParamsResponseFormatJSONObject = /* values here */
-```
-
-### `components.ResponseFormatJSONSchema`
-
-```python
-value: components.ResponseFormatJSONSchema = /* values here */
-```
-
-### `components.ResponseFormatTextGrammar`
-
-```python
-value: components.ResponseFormatTextGrammar = /* values here */
-```
-
-### `components.ChatGenerationParamsResponseFormatPython`
-
-```python
-value: components.ChatGenerationParamsResponseFormatPython = /* values here */
-```
-
@@ -1,17 +0,0 @@
-# ChatGenerationParamsStop
-
-
-## Supported Types
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
-### `List[str]`
-
-```python
-value: List[str] = /* values here */
-```
-
@@ -1,12 +0,0 @@
-# ChatGenerationTokenUsage
-
-
-## Fields
-
-| Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      |
-| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
-| `completion_tokens`                                                                              | *float*                                                                                          | :heavy_check_mark:                                                                               | N/A                                                                                              |
-| `prompt_tokens`                                                                                  | *float*                                                                                          | :heavy_check_mark:                                                                               | N/A                                                                                              |
-| `total_tokens`                                                                                   | *float*                                                                                          | :heavy_check_mark:                                                                               | N/A                                                                                              |
-| `completion_tokens_details`                                                                      | [OptionalNullable[components.CompletionTokensDetails]](../components/completiontokensdetails.md) | :heavy_minus_sign:                                                                               | N/A                                                                                              |
-| `prompt_tokens_details`                                                                          | [OptionalNullable[components.PromptTokensDetails]](../components/prompttokensdetails.md)         | :heavy_minus_sign:                                                                               | N/A                                                                                              |
@@ -1,29 +0,0 @@
-# ChatMessageContentItem
-
-
-## Supported Types
-
-### `components.ChatMessageContentItemText`
-
-```python
-value: components.ChatMessageContentItemText = /* values here */
-```
-
-### `components.ChatMessageContentItemImage`
-
-```python
-value: components.ChatMessageContentItemImage = /* values here */
-```
-
-### `components.ChatMessageContentItemAudio`
-
-```python
-value: components.ChatMessageContentItemAudio = /* values here */
-```
-
-### `components.ChatMessageContentItemVideo`
-
-```python
-value: components.ChatMessageContentItemVideo = /* values here */
-```
-
@@ -1,9 +0,0 @@
-# ChatMessageContentItemAudio
-
-
-## Fields
-
-| Field                                                                                                      | Type                                                                                                       | Required                                                                                                   | Description                                                                                                |
-| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `type`                                                                                                     | *Literal["input_audio"]*                                                                                   | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
-| `input_audio`                                                                                              | [components.ChatMessageContentItemAudioInputAudio](../components/chatmessagecontentitemaudioinputaudio.md) | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
@@ -1,14 +0,0 @@
-# ChatMessageContentItemAudioFormat
-
-
-## Values
-
-| Name    | Value   |
-| ------- | ------- |
-| `WAV`   | wav     |
-| `MP3`   | mp3     |
-| `FLAC`  | flac    |
-| `M4A`   | m4a     |
-| `OGG`   | ogg     |
-| `PCM16` | pcm16   |
-| `PCM24` | pcm24   |
@@ -1,9 +0,0 @@
-# ChatMessageContentItemAudioInputAudio
-
-
-## Fields
-
-| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
-| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `data`                                                                                             | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `format_`                                                                                          | [components.ChatMessageContentItemAudioFormat](../components/chatmessagecontentitemaudioformat.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
@@ -1,9 +0,0 @@
-# ChatMessageContentItemImage
-
-
-## Fields
-
-| Field                                            | Type                                             | Required                                         | Description                                      |
-| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
-| `type`                                           | *Literal["image_url"]*                           | :heavy_check_mark:                               | N/A                                              |
-| `image_url`                                      | [components.ImageURL](../components/imageurl.md) | :heavy_check_mark:                               | N/A                                              |
@@ -1,10 +0,0 @@
-# ChatMessageContentItemImageDetail
-
-
-## Values
-
-| Name   | Value  |
-| ------ | ------ |
-| `AUTO` | auto   |
-| `LOW`  | low    |
-| `HIGH` | high   |
@@ -1,9 +0,0 @@
-# ChatMessageContentItemText
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `type`             | *Literal["text"]*  | :heavy_check_mark: | N/A                |
-| `text`             | *str*              | :heavy_check_mark: | N/A                |
@@ -1,9 +0,0 @@
-# ChatMessageContentItemVideo
-
-
-## Fields
-
-| Field                                            | Type                                             | Required                                         | Description                                      |
-| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
-| `type`                                           | *Literal["input_video"]*                         | :heavy_check_mark:                               | N/A                                              |
-| `video_url`                                      | [components.VideoURL](../components/videourl.md) | :heavy_check_mark:                               | N/A                                              |
@@ -1,11 +0,0 @@
-# ChatMessageTokenLogprob
-
-
-## Fields
-
-| Field                                                      | Type                                                       | Required                                                   | Description                                                |
-| ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
-| `token`                                                    | *str*                                                      | :heavy_check_mark:                                         | N/A                                                        |
-| `logprob`                                                  | *float*                                                    | :heavy_check_mark:                                         | N/A                                                        |
-| `bytes_`                                                   | List[*float*]                                              | :heavy_check_mark:                                         | N/A                                                        |
-| `top_logprobs`                                             | List[[components.TopLogprob](../components/toplogprob.md)] | :heavy_check_mark:                                         | N/A                                                        |
@@ -1,9 +0,0 @@
-# ChatMessageTokenLogprobs
-
-
-## Fields
-
-| Field                                                                                | Type                                                                                 | Required                                                                             | Description                                                                          |
-| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-| `content`                                                                            | List[[components.ChatMessageTokenLogprob](../components/chatmessagetokenlogprob.md)] | :heavy_check_mark:                                                                   | N/A                                                                                  |
-| `refusal`                                                                            | List[[components.ChatMessageTokenLogprob](../components/chatmessagetokenlogprob.md)] | :heavy_check_mark:                                                                   | N/A                                                                                  |
@@ -1,10 +0,0 @@
-# ChatMessageToolCall
-
-
-## Fields
-
-| Field                                                                                  | Type                                                                                   | Required                                                                               | Description                                                                            |
-| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| `id`                                                                                   | *str*                                                                                  | :heavy_check_mark:                                                                     | N/A                                                                                    |
-| `type`                                                                                 | *Literal["function"]*                                                                  | :heavy_check_mark:                                                                     | N/A                                                                                    |
-| `function`                                                                             | [components.ChatMessageToolCallFunction](../components/chatmessagetoolcallfunction.md) | :heavy_check_mark:                                                                     | N/A                                                                                    |
@@ -1,9 +0,0 @@
-# ChatMessageToolCallFunction
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `name`             | *str*              | :heavy_check_mark: | N/A                |
-| `arguments`        | *str*              | :heavy_check_mark: | N/A                |
@@ -1,14 +0,0 @@
-# ChatResponse
-
-
-## Fields
-
-| Field                                                                                      | Type                                                                                       | Required                                                                                   | Description                                                                                |
-| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
-| `id`                                                                                       | *str*                                                                                      | :heavy_check_mark:                                                                         | N/A                                                                                        |
-| `choices`                                                                                  | List[[components.ChatResponseChoice](../components/chatresponsechoice.md)]                 | :heavy_check_mark:                                                                         | N/A                                                                                        |
-| `created`                                                                                  | *float*                                                                                    | :heavy_check_mark:                                                                         | N/A                                                                                        |
-| `model`                                                                                    | *str*                                                                                      | :heavy_check_mark:                                                                         | N/A                                                                                        |
-| `object`                                                                                   | *Literal["chat.completion"]*                                                               | :heavy_check_mark:                                                                         | N/A                                                                                        |
-| `system_fingerprint`                                                                       | *OptionalNullable[str]*                                                                    | :heavy_minus_sign:                                                                         | N/A                                                                                        |
-| `usage`                                                                                    | [Optional[components.ChatGenerationTokenUsage]](../components/chatgenerationtokenusage.md) | :heavy_minus_sign:                                                                         | N/A                                                                                        |
@@ -1,11 +0,0 @@
-# ChatResponseChoice
-
-
-## Fields
-
-| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
-| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `finish_reason`                                                                                    | [Nullable[components.ChatCompletionFinishReason]](../components/chatcompletionfinishreason.md)     | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `index`                                                                                            | *float*                                                                                            | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `message`                                                                                          | [components.AssistantMessage](../components/assistantmessage.md)                                   | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `logprobs`                                                                                         | [OptionalNullable[components.ChatMessageTokenLogprobs]](../components/chatmessagetokenlogprobs.md) | :heavy_minus_sign:                                                                                 | N/A                                                                                                |
@@ -1,11 +0,0 @@
-# ChatStreamingChoice
-
-
-## Fields
-
-| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
-| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `delta`                                                                                            | [components.ChatStreamingMessageChunk](../components/chatstreamingmessagechunk.md)                 | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `finish_reason`                                                                                    | [Nullable[components.ChatCompletionFinishReason]](../components/chatcompletionfinishreason.md)     | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `index`                                                                                            | *float*                                                                                            | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `logprobs`                                                                                         | [OptionalNullable[components.ChatMessageTokenLogprobs]](../components/chatmessagetokenlogprobs.md) | :heavy_minus_sign:                                                                                 | N/A                                                                                                |
@@ -1,12 +0,0 @@
-# ChatStreamingMessageChunk
-
-
-## Fields
-
-| Field                                                                                                | Type                                                                                                 | Required                                                                                             | Description                                                                                          |
-| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `role`                                                                                               | [Optional[components.ChatStreamingMessageChunkRole]](../components/chatstreamingmessagechunkrole.md) | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `content`                                                                                            | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `reasoning`                                                                                          | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `refusal`                                                                                            | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `tool_calls`                                                                                         | List[[components.ChatStreamingMessageToolCall](../components/chatstreamingmessagetoolcall.md)]       | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
@@ -1,8 +0,0 @@
-# ChatStreamingMessageChunkRole
-
-
-## Values
-
-| Name        | Value       |
-| ----------- | ----------- |
-| `ASSISTANT` | assistant   |
@@ -1,11 +0,0 @@
-# ChatStreamingMessageToolCall
-
-
-## Fields
-
-| Field                                                                                                              | Type                                                                                                               | Required                                                                                                           | Description                                                                                                        |
-| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
-| `index`                                                                                                            | *float*                                                                                                            | :heavy_check_mark:                                                                                                 | N/A                                                                                                                |
-| `id`                                                                                                               | *Optional[str]*                                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |
-| `type`                                                                                                             | *Optional[Literal["function"]]*                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |
-| `function`                                                                                                         | [Optional[components.ChatStreamingMessageToolCallFunction]](../components/chatstreamingmessagetoolcallfunction.md) | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |
@@ -1,9 +0,0 @@
-# ChatStreamingMessageToolCallFunction
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `name`             | *Optional[str]*    | :heavy_minus_sign: | N/A                |
-| `arguments`        | *Optional[str]*    | :heavy_minus_sign: | N/A                |
@@ -1,8 +0,0 @@
-# ChatStreamingResponseChunk
-
-
-## Fields
-
-| Field                                                                                        | Type                                                                                         | Required                                                                                     | Description                                                                                  |
-| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
-| `data`                                                                                       | [components.ChatStreamingResponseChunkData](../components/chatstreamingresponsechunkdata.md) | :heavy_check_mark:                                                                           | N/A                                                                                          |
@@ -1,15 +0,0 @@
-# ChatStreamingResponseChunkData
-
-
-## Fields
-
-| Field                                                                                                    | Type                                                                                                     | Required                                                                                                 | Description                                                                                              |
-| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `id`                                                                                                     | *str*                                                                                                    | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
-| `choices`                                                                                                | List[[components.ChatStreamingChoice](../components/chatstreamingchoice.md)]                             | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
-| `created`                                                                                                | *float*                                                                                                  | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
-| `model`                                                                                                  | *str*                                                                                                    | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
-| `object`                                                                                                 | *Literal["chat.completion.chunk"]*                                                                       | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
-| `system_fingerprint`                                                                                     | *OptionalNullable[str]*                                                                                  | :heavy_minus_sign:                                                                                       | N/A                                                                                                      |
-| `error`                                                                                                  | [Optional[components.ChatStreamingResponseChunkError]](../components/chatstreamingresponsechunkerror.md) | :heavy_minus_sign:                                                                                       | N/A                                                                                                      |
-| `usage`                                                                                                  | [Optional[components.ChatGenerationTokenUsage]](../components/chatgenerationtokenusage.md)               | :heavy_minus_sign:                                                                                       | N/A                                                                                                      |
@@ -1,9 +0,0 @@
-# ChatStreamingResponseChunkError
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `message`          | *str*              | :heavy_check_mark: | N/A                |
-| `code`             | *float*            | :heavy_check_mark: | N/A                |
@@ -1,8 +1,10 @@
 # ChatStreamOptions

+Streaming configuration options
+

 ## Fields

-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `include_usage`    | *Optional[bool]*   | :heavy_minus_sign: | N/A                |
+| Field                                                                                                                                                                                                  | Type                                                                                                                                                                                                   | Required                                                                                                                                                                                               | Description                                                                                                                                                                                            | Example                                                                                                                                                                                                |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| ~~`include_usage`~~                                                                                                                                                                                    | *Optional[bool]*                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                     | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.<br/><br/>Deprecated: This field has no effect. Full usage details are always included. | true                                                                                                                                                                                                   |
@@ -1,17 +1,25 @@
 # Code


-## Supported Types
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
-### `float`
-
-```python
-value: float = /* values here */
-```
+## Values

+| Name                             | Value                            |
+| -------------------------------- | -------------------------------- |
+| `SERVER_ERROR`                   | server_error                     |
+| `RATE_LIMIT_EXCEEDED`            | rate_limit_exceeded              |
+| `INVALID_PROMPT`                 | invalid_prompt                   |
+| `VECTOR_STORE_TIMEOUT`           | vector_store_timeout             |
+| `INVALID_IMAGE`                  | invalid_image                    |
+| `INVALID_IMAGE_FORMAT`           | invalid_image_format             |
+| `INVALID_BASE64_IMAGE`           | invalid_base64_image             |
+| `INVALID_IMAGE_URL`              | invalid_image_url                |
+| `IMAGE_TOO_LARGE`                | image_too_large                  |
+| `IMAGE_TOO_SMALL`                | image_too_small                  |
+| `IMAGE_PARSE_ERROR`              | image_parse_error                |
+| `IMAGE_CONTENT_POLICY_VIOLATION` | image_content_policy_violation   |
+| `INVALID_IMAGE_MODE`             | invalid_image_mode               |
+| `IMAGE_FILE_TOO_LARGE`           | image_file_too_large             |
+| `UNSUPPORTED_IMAGE_MEDIA_TYPE`   | unsupported_image_media_type     |
+| `EMPTY_IMAGE_FILE`               | empty_image_file                 |
+| `FAILED_TO_DOWNLOAD_IMAGE`       | failed_to_download_image         |
+| `IMAGE_FILE_NOT_FOUND`           | image_file_not_found             |
@@ -1,25 +0,0 @@
-# CodeEnum
-
-
-## Values
-
-| Name                             | Value                            |
-| -------------------------------- | -------------------------------- |
-| `SERVER_ERROR`                   | server_error                     |
-| `RATE_LIMIT_EXCEEDED`            | rate_limit_exceeded              |
-| `INVALID_PROMPT`                 | invalid_prompt                   |
-| `VECTOR_STORE_TIMEOUT`           | vector_store_timeout             |
-| `INVALID_IMAGE`                  | invalid_image                    |
-| `INVALID_IMAGE_FORMAT`           | invalid_image_format             |
-| `INVALID_BASE64_IMAGE`           | invalid_base64_image             |
-| `INVALID_IMAGE_URL`              | invalid_image_url                |
-| `IMAGE_TOO_LARGE`                | image_too_large                  |
-| `IMAGE_TOO_SMALL`                | image_too_small                  |
-| `IMAGE_PARSE_ERROR`              | image_parse_error                |
-| `IMAGE_CONTENT_POLICY_VIOLATION` | image_content_policy_violation   |
-| `INVALID_IMAGE_MODE`             | invalid_image_mode               |
-| `IMAGE_FILE_TOO_LARGE`           | image_file_too_large             |
-| `UNSUPPORTED_IMAGE_MEDIA_TYPE`   | unsupported_image_media_type     |
-| `EMPTY_IMAGE_FILE`               | empty_image_file                 |
-| `FAILED_TO_DOWNLOAD_IMAGE`       | failed_to_download_image         |
-| `IMAGE_FILE_NOT_FOUND`           | image_file_not_found             |
@@ -1,11 +0,0 @@
-# CompletionChoice
-
-
-## Fields
-
-| Field                                                                                  | Type                                                                                   | Required                                                                               | Description                                                                            |
-| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| `text`                                                                                 | *str*                                                                                  | :heavy_check_mark:                                                                     | N/A                                                                                    |
-| `index`                                                                                | *float*                                                                                | :heavy_check_mark:                                                                     | N/A                                                                                    |
-| `logprobs`                                                                             | [Nullable[components.CompletionLogprobs]](../components/completionlogprobs.md)         | :heavy_check_mark:                                                                     | N/A                                                                                    |
-| `finish_reason`                                                                        | [Nullable[components.CompletionFinishReason]](../components/completionfinishreason.md) | :heavy_check_mark:                                                                     | N/A                                                                                    |
@@ -1,28 +0,0 @@
-# CompletionCreateParams
-
-
-## Fields
-
-| Field                                                                                                                                | Type                                                                                                                                 | Required                                                                                                                             | Description                                                                                                                          |
-| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `model`                                                                                                                              | *Optional[str]*                                                                                                                      | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `models`                                                                                                                             | List[*str*]                                                                                                                          | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `prompt`                                                                                                                             | [components.Prompt](../components/prompt.md)                                                                                         | :heavy_check_mark:                                                                                                                   | N/A                                                                                                                                  |
-| `best_of`                                                                                                                            | *OptionalNullable[int]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `echo`                                                                                                                               | *OptionalNullable[bool]*                                                                                                             | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `frequency_penalty`                                                                                                                  | *OptionalNullable[float]*                                                                                                            | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `logit_bias`                                                                                                                         | Dict[str, *float*]                                                                                                                   | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `logprobs`                                                                                                                           | *OptionalNullable[int]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `max_tokens`                                                                                                                         | *OptionalNullable[int]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `n`                                                                                                                                  | *OptionalNullable[int]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `presence_penalty`                                                                                                                   | *OptionalNullable[float]*                                                                                                            | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `seed`                                                                                                                               | *OptionalNullable[int]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `stop`                                                                                                                               | [OptionalNullable[components.CompletionCreateParamsStop]](../components/completioncreateparamsstop.md)                               | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `stream`                                                                                                                             | *Optional[bool]*                                                                                                                     | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `stream_options`                                                                                                                     | [OptionalNullable[components.StreamOptions]](../components/streamoptions.md)                                                         | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `suffix`                                                                                                                             | *OptionalNullable[str]*                                                                                                              | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `temperature`                                                                                                                        | *OptionalNullable[float]*                                                                                                            | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `top_p`                                                                                                                              | *OptionalNullable[float]*                                                                                                            | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `user`                                                                                                                               | *Optional[str]*                                                                                                                      | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `metadata`                                                                                                                           | Dict[str, *str*]                                                                                                                     | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
-| `response_format`                                                                                                                    | [OptionalNullable[components.CompletionCreateParamsResponseFormatUnion]](../components/completioncreateparamsresponseformatunion.md) | :heavy_minus_sign:                                                                                                                   | N/A                                                                                                                                  |
@@ -1,8 +0,0 @@
-# CompletionCreateParamsResponseFormatJSONObject
-
-
-## Fields
-
-| Field                    | Type                     | Required                 | Description              |
-| ------------------------ | ------------------------ | ------------------------ | ------------------------ |
-| `type`                   | *Literal["json_object"]* | :heavy_check_mark:       | N/A                      |
@@ -1,8 +0,0 @@
-# CompletionCreateParamsResponseFormatPython
-
-
-## Fields
-
-| Field               | Type                | Required            | Description         |
-| ------------------- | ------------------- | ------------------- | ------------------- |
-| `type`              | *Literal["python"]* | :heavy_check_mark:  | N/A                 |
@@ -1,8 +0,0 @@
-# CompletionCreateParamsResponseFormatText
-
-
-## Fields
-
-| Field              | Type               | Required           | Description        |
-| ------------------ | ------------------ | ------------------ | ------------------ |
-| `type`             | *Literal["text"]*  | :heavy_check_mark: | N/A                |
@@ -1,35 +0,0 @@
-# CompletionCreateParamsResponseFormatUnion
-
-
-## Supported Types
-
-### `components.CompletionCreateParamsResponseFormatText`
-
-```python
-value: components.CompletionCreateParamsResponseFormatText = /* values here */
-```
-
-### `components.CompletionCreateParamsResponseFormatJSONObject`
-
-```python
-value: components.CompletionCreateParamsResponseFormatJSONObject = /* values here */
-```
-
-### `components.ResponseFormatJSONSchema`
-
-```python
-value: components.ResponseFormatJSONSchema = /* values here */
-```
-
-### `components.ResponseFormatTextGrammar`
-
-```python
-value: components.ResponseFormatTextGrammar = /* values here */
-```
-
-### `components.CompletionCreateParamsResponseFormatPython`
-
-```python
-value: components.CompletionCreateParamsResponseFormatPython = /* values here */
-```
-
@@ -1,10 +0,0 @@
-# CompletionFinishReason
-
-
-## Values
-
-| Name             | Value            |
-| ---------------- | ---------------- |
-| `STOP`           | stop             |
-| `LENGTH`         | length           |
-| `CONTENT_FILTER` | content_filter   |
@@ -1,11 +0,0 @@
-# CompletionLogprobs
-
-
-## Fields
-
-| Field                    | Type                     | Required                 | Description              |
-| ------------------------ | ------------------------ | ------------------------ | ------------------------ |
-| `tokens`                 | List[*str*]              | :heavy_check_mark:       | N/A                      |
-| `token_logprobs`         | List[*float*]            | :heavy_check_mark:       | N/A                      |
-| `top_logprobs`           | List[Dict[str, *float*]] | :heavy_check_mark:       | N/A                      |
-| `text_offset`            | List[*float*]            | :heavy_check_mark:       | N/A                      |
@@ -1,14 +0,0 @@
-# CompletionResponse
-
-
-## Fields
-
-| Field                                                                    | Type                                                                     | Required                                                                 | Description                                                              |
-| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
-| `id`                                                                     | *str*                                                                    | :heavy_check_mark:                                                       | N/A                                                                      |
-| `object`                                                                 | *Literal["text_completion"]*                                             | :heavy_check_mark:                                                       | N/A                                                                      |
-| `created`                                                                | *float*                                                                  | :heavy_check_mark:                                                       | N/A                                                                      |
-| `model`                                                                  | *str*                                                                    | :heavy_check_mark:                                                       | N/A                                                                      |
-| `system_fingerprint`                                                     | *Optional[str]*                                                          | :heavy_minus_sign:                                                       | N/A                                                                      |
-| `choices`                                                                | List[[components.CompletionChoice](../components/completionchoice.md)]   | :heavy_check_mark:                                                       | N/A                                                                      |
-| `usage`                                                                  | [Optional[components.CompletionUsage]](../components/completionusage.md) | :heavy_minus_sign:                                                       | N/A                                                                      |
@@ -1,11 +1,13 @@
 # CompletionTokensDetails

+Detailed completion token usage
+

 ## Fields

 | Field                        | Type                         | Required                     | Description                  |
 | ---------------------------- | ---------------------------- | ---------------------------- | ---------------------------- |
-| `reasoning_tokens`           | *OptionalNullable[float]*    | :heavy_minus_sign:           | N/A                          |
-| `audio_tokens`               | *OptionalNullable[float]*    | :heavy_minus_sign:           | N/A                          |
-| `accepted_prediction_tokens` | *OptionalNullable[float]*    | :heavy_minus_sign:           | N/A                          |
-| `rejected_prediction_tokens` | *OptionalNullable[float]*    | :heavy_minus_sign:           | N/A                          |
+| `accepted_prediction_tokens` | *OptionalNullable[int]*      | :heavy_minus_sign:           | Accepted prediction tokens   |
+| `audio_tokens`               | *OptionalNullable[int]*      | :heavy_minus_sign:           | Tokens used for audio output |
+| `reasoning_tokens`           | *OptionalNullable[int]*      | :heavy_minus_sign:           | Tokens used for reasoning    |
+| `rejected_prediction_tokens` | *OptionalNullable[int]*      | :heavy_minus_sign:           | Rejected prediction tokens   |
@@ -1,10 +0,0 @@
-# CompletionUsage
-
-
-## Fields
-
-| Field               | Type                | Required            | Description         |
-| ------------------- | ------------------- | ------------------- | ------------------- |
-| `prompt_tokens`     | *float*             | :heavy_check_mark:  | N/A                 |
-| `completion_tokens` | *float*             | :heavy_check_mark:  | N/A                 |
-| `total_tokens`      | *float*             | :heavy_check_mark:  | N/A                 |
@@ -1,10 +1,12 @@
 # CostDetails

+Breakdown of upstream inference costs
+

 ## Fields

-| Field                            | Type                             | Required                         | Description                      |
-| -------------------------------- | -------------------------------- | -------------------------------- | -------------------------------- |
-| `upstream_inference_cost`        | *OptionalNullable[float]*        | :heavy_minus_sign:               | N/A                              |
-| `upstream_inference_input_cost`  | *float*                          | :heavy_check_mark:               | N/A                              |
-| `upstream_inference_output_cost` | *float*                          | :heavy_check_mark:               | N/A                              |
+| Field                                 | Type                                  | Required                              | Description                           |
+| ------------------------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------- |
+| `upstream_inference_completions_cost` | *float*                               | :heavy_check_mark:                    | N/A                                   |
+| `upstream_inference_cost`             | *OptionalNullable[float]*             | :heavy_minus_sign:                    | N/A                                   |
+| `upstream_inference_prompt_cost`      | *float*                               | :heavy_check_mark:                    | N/A                                   |
@@ -1,12 +0,0 @@
-# CreateChargeRequest
-
-Create a Coinbase charge for crypto payment
-
-
-## Fields
-
-| Field                                          | Type                                           | Required                                       | Description                                    |
-| ---------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- |
-| `amount`                                       | *float*                                        | :heavy_check_mark:                             | N/A                                            |
-| `sender`                                       | *str*                                          | :heavy_check_mark:                             | N/A                                            |
-| `chain_id`                                     | [components.ChainID](../components/chainid.md) | :heavy_check_mark:                             | N/A                                            |
@@ -2,8 +2,8 @@

 Data collection setting. If no available model provider meets the requirement, your request will return an error.
 - allow: (default) allow providers which store user data non-transiently and may train on it
- deny: use only providers which do not collect user data.

+- deny: use only providers which do not collect user data.


 ## Values
@@ -7,6 +7,9 @@ Default parameters for this model

 | Field                     | Type                      | Required                  | Description               |
 | ------------------------- | ------------------------- | ------------------------- | ------------------------- |
+| `frequency_penalty`       | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `presence_penalty`        | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `repetition_penalty`      | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
 | `temperature`             | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
-| `top_p`                   | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
-| `frequency_penalty`       | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `top_k`                   | *OptionalNullable[int]*   | :heavy_minus_sign:        | N/A                       |
+| `top_p`                   | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
@@ -1,11 +0,0 @@
-# Effort
-
-
-## Values
-
-| Name      | Value     |
-| --------- | --------- |
-| `MINIMAL` | minimal   |
-| `LOW`     | low       |
-| `MEDIUM`  | medium    |
-| `HIGH`    | high      |
@@ -1,9 +0,0 @@
-# Engine
-
-
-## Values
-
-| Name     | Value    |
-| -------- | -------- |
-| `NATIVE` | native   |
-| `EXA`    | exa      |
@@ -0,0 +1,11 @@
+# Error
+
+Error information
+
+
+## Fields
+
+| Field               | Type                | Required            | Description         | Example             |
+| ------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
+| `code`              | *int*               | :heavy_check_mark:  | Error code          | 429                 |
+| `message`           | *str*               | :heavy_check_mark:  | Error message       | Rate limit exceeded |
@@ -5,7 +5,7 @@

 | Field                                                            | Type                                                             | Required                                                         | Description                                                      |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `type`                                                           | [components.FileCitationType](../components/filecitationtype.md) | :heavy_check_mark:                                               | N/A                                                              |
 | `file_id`                                                        | *str*                                                            | :heavy_check_mark:                                               | N/A                                                              |
 | `filename`                                                       | *str*                                                            | :heavy_check_mark:                                               | N/A                                                              |
-| `index`                                                          | *float*                                                          | :heavy_check_mark:                                               | N/A                                                              |
+| `index`                                                          | *int*                                                            | :heavy_check_mark:                                               | N/A                                                              |
+| `type`                                                           | [components.FileCitationType](../components/filecitationtype.md) | :heavy_check_mark:                                               | N/A                                                              |
@@ -5,6 +5,6 @@

 | Field                                                    | Type                                                     | Required                                                 | Description                                              |
 | -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
-| `type`                                                   | [components.FilePathType](../components/filepathtype.md) | :heavy_check_mark:                                       | N/A                                                      |
 | `file_id`                                                | *str*                                                    | :heavy_check_mark:                                       | N/A                                                      |
-| `index`                                                  | *float*                                                  | :heavy_check_mark:                                       | N/A                                                      |
+| `index`                                                  | *int*                                                    | :heavy_check_mark:                                       | N/A                                                      |
+| `type`                                                   | [components.FilePathType](../components/filepathtype.md) | :heavy_check_mark:                                       | N/A                                                      |
@@ -1,8 +0,0 @@
-# IDFileParser
-
-
-## Values
-
-| Name          | Value         |
-| ------------- | ------------- |
-| `FILE_PARSER` | file-parser   |
@@ -1,8 +0,0 @@
-# IDModeration
-
-
-## Values
-
-| Name         | Value        |
-| ------------ | ------------ |
-| `MODERATION` | moderation   |
@@ -1,8 +0,0 @@
-# IDWeb
-
-
-## Values
-
-| Name  | Value |
-| ----- | ----- |
-| `WEB` | web   |
@@ -1,17 +0,0 @@
-# Ignore
-
-
-## Supported Types
-
-### `components.ProviderName`
-
-```python
-value: components.ProviderName = /* values here */
-```
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
@@ -1,9 +0,0 @@
-# ImageURL
-
-
-## Fields
-
-| Field                                                                                                        | Type                                                                                                         | Required                                                                                                     | Description                                                                                                  |
-| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
-| `url`                                                                                                        | *str*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
-| `detail`                                                                                                     | [Optional[components.ChatMessageContentItemImageDetail]](../components/chatmessagecontentitemimagedetail.md) | :heavy_minus_sign:                                                                                           | N/A                                                                                                          |
@@ -5,4 +5,4 @@

 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `cached_tokens`    | *float*            | :heavy_check_mark: | N/A                |
+| `cached_tokens`    | *int*              | :heavy_check_mark: | N/A                |
@@ -1,11 +0,0 @@
-# JSONSchemaConfig
-
-
-## Fields
-
-| Field                    | Type                     | Required                 | Description              |
-| ------------------------ | ------------------------ | ------------------------ | ------------------------ |
-| `name`                   | *str*                    | :heavy_check_mark:       | N/A                      |
-| `description`            | *Optional[str]*          | :heavy_minus_sign:       | N/A                      |
-| `schema_`                | Dict[str, *Any*]         | :heavy_minus_sign:       | N/A                      |
-| `strict`                 | *OptionalNullable[bool]* | :heavy_minus_sign:       | N/A                      |
@@ -7,9 +7,9 @@ List of available endpoints for a model

 | Field                                                                                                                                             | Type                                                                                                                                              | Required                                                                                                                                          | Description                                                                                                                                       | Example                                                                                                                                           |
 | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`                                                                                                                                              | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Unique identifier for the model                                                                                                                   | openai/gpt-4                                                                                                                                      |
-| `name`                                                                                                                                            | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Display name of the model                                                                                                                         | GPT-4                                                                                                                                             |
-| `created`                                                                                                                                         | *float*                                                                                                                                           | :heavy_check_mark:                                                                                                                                | Unix timestamp of when the model was created                                                                                                      | 1692901234                                                                                                                                        |
+| `architecture`                                                                                                                                    | [components.Architecture](../components/architecture.md)                                                                                          | :heavy_check_mark:                                                                                                                                | N/A                                                                                                                                               | {<br/>"input_modalities": [<br/>"text"<br/>],<br/>"instruct_type": "chatml",<br/>"modality": "text-\u003etext",<br/>"output_modalities": [<br/>"text"<br/>],<br/>"tokenizer": "GPT"<br/>} |
+| `created`                                                                                                                                         | *int*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Unix timestamp of when the model was created                                                                                                      | 1692901234                                                                                                                                        |
 | `description`                                                                                                                                     | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Description of the model                                                                                                                          | GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.                                                        |
-| `architecture`                                                                                                                                    | [components.Architecture](../components/architecture.md)                                                                                          | :heavy_check_mark:                                                                                                                                | N/A                                                                                                                                               | {<br/>"tokenizer": "GPT",<br/>"instruct_type": "chatml",<br/>"modality": "text-\u003etext",<br/>"input_modalities": [<br/>"text"<br/>],<br/>"output_modalities": [<br/>"text"<br/>]<br/>} |
-| `endpoints`                                                                                                                                       | List[[components.PublicEndpoint](../components/publicendpoint.md)]                                                                                | :heavy_check_mark:                                                                                                                                | List of available endpoints for this model                                                                                                        |                                                                                                                                                   |
+| `endpoints`                                                                                                                                       | List[[components.PublicEndpoint](../components/publicendpoint.md)]                                                                                | :heavy_check_mark:                                                                                                                                | List of available endpoints for this model                                                                                                        |                                                                                                                                                   |
+| `id`                                                                                                                                              | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Unique identifier for the model                                                                                                                   | openai/gpt-4                                                                                                                                      |
+| `name`                                                                                                                                            | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Display name of the model                                                                                                                         | GPT-4                                                                                                                                             |
@@ -1,14 +0,0 @@
-# MaxPrice
-
-The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion.
-
-
-## Fields
-
-| Field                                                     | Type                                                      | Required                                                  | Description                                               |
-| --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- |
-| `prompt`                                                  | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `completion`                                              | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `image`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `audio`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `request`                                                 | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
@@ -1,35 +0,0 @@
-# Message
-
-
-## Supported Types
-
-### `components.SystemMessage`
-
-```python
-value: components.SystemMessage = /* values here */
-```
-
-### `components.UserMessage`
-
-```python
-value: components.UserMessage = /* values here */
-```
-
-### `components.MessageDeveloper`
-
-```python
-value: components.MessageDeveloper = /* values here */
-```
-
-### `components.AssistantMessage`
-
-```python
-value: components.AssistantMessage = /* values here */
-```
-
-### `components.ToolResponseMessage`
-
-```python
-value: components.ToolResponseMessage = /* values here */
-```
-
@@ -1,17 +0,0 @@
-# MessageContent
-
-
-## Supported Types
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
-### `List[components.ChatMessageContentItemText]`
-
-```python
-value: List[components.ChatMessageContentItemText] = /* values here */
-```
-
@@ -1,10 +0,0 @@
-# MessageDeveloper
-
-
-## Fields
-
-| Field                                                        | Type                                                         | Required                                                     | Description                                                  |
-| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| `role`                                                       | *Literal["developer"]*                                       | :heavy_check_mark:                                           | N/A                                                          |
-| `content`                                                    | [components.MessageContent](../components/messagecontent.md) | :heavy_check_mark:                                           | N/A                                                          |
-| `name`                                                       | *Optional[str]*                                              | :heavy_minus_sign:                                           | N/A                                                          |
@@ -0,0 +1,10 @@
+# Modality
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `TEXT`  | text    |
+| `IMAGE` | image   |
+| `AUDIO` | audio   |
@@ -5,18 +5,24 @@ Information about an AI model available on OpenRouter

 ## Fields

-| Field                                                                                                                                             | Type                                                                                                                                              | Required                                                                                                                                          | Description                                                                                                                                       | Example                                                                                                                                           |
-| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`                                                                                                                                              | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Unique identifier for the model                                                                                                                   | openai/gpt-4                                                                                                                                      |
-| `canonical_slug`                                                                                                                                  | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Canonical slug for the model                                                                                                                      | openai/gpt-4                                                                                                                                      |
-| `hugging_face_id`                                                                                                                                 | *OptionalNullable[str]*                                                                                                                           | :heavy_minus_sign:                                                                                                                                | Hugging Face model identifier, if applicable                                                                                                      | microsoft/DialoGPT-medium                                                                                                                         |
-| `name`                                                                                                                                            | *str*                                                                                                                                             | :heavy_check_mark:                                                                                                                                | Display name of the model                                                                                                                         | GPT-4                                                                                                                                             |
-| `created`                                                                                                                                         | *float*                                                                                                                                           | :heavy_check_mark:                                                                                                                                | Unix timestamp of when the model was created                                                                                                      | 1692901234                                                                                                                                        |
-| `description`                                                                                                                                     | *Optional[str]*                                                                                                                                   | :heavy_minus_sign:                                                                                                                                | Description of the model                                                                                                                          | GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.                                                        |
-| `pricing`                                                                                                                                         | [components.PublicPricing](../components/publicpricing.md)                                                                                        | :heavy_check_mark:                                                                                                                                | Pricing information for the model                                                                                                                 | {<br/>"prompt": "0.00003",<br/>"completion": "0.00006",<br/>"request": "0",<br/>"image": "0"<br/>}                                                |
-| `context_length`                                                                                                                                  | *Nullable[float]*                                                                                                                                 | :heavy_check_mark:                                                                                                                                | Maximum context length in tokens                                                                                                                  | 8192                                                                                                                                              |
-| `architecture`                                                                                                                                    | [components.ModelArchitecture](../components/modelarchitecture.md)                                                                                | :heavy_check_mark:                                                                                                                                | Model architecture information                                                                                                                    | {<br/>"tokenizer": "GPT",<br/>"instruct_type": "chatml",<br/>"modality": "text-\u003etext",<br/>"input_modalities": [<br/>"text"<br/>],<br/>"output_modalities": [<br/>"text"<br/>]<br/>} |
-| `top_provider`                                                                                                                                    | [components.TopProviderInfo](../components/topproviderinfo.md)                                                                                    | :heavy_check_mark:                                                                                                                                | Information about the top provider for this model                                                                                                 | {<br/>"context_length": 8192,<br/>"max_completion_tokens": 4096,<br/>"is_moderated": true<br/>}                                                   |
-| `per_request_limits`                                                                                                                              | [Nullable[components.PerRequestLimits]](../components/perrequestlimits.md)                                                                        | :heavy_check_mark:                                                                                                                                | Per-request token limits                                                                                                                          | {<br/>"prompt_tokens": 1000,<br/>"completion_tokens": 1000<br/>}                                                                                  |
-| `supported_parameters`                                                                                                                            | List[[components.Parameter](../components/parameter.md)]                                                                                          | :heavy_check_mark:                                                                                                                                | List of supported parameters for this model                                                                                                       |                                                                                                                                                   |
-| `default_parameters`                                                                                                                              | [Nullable[components.DefaultParameters]](../components/defaultparameters.md)                                                                      | :heavy_check_mark:                                                                                                                                | Default parameters for this model                                                                                                                 | {<br/>"temperature": 0.7,<br/>"top_p": 0.9,<br/>"frequency_penalty": 0<br/>}                                                                      |
+| Field                                                                                                                                                                                                                | Type                                                                                                                                                                                                                 | Required                                                                                                                                                                                                             | Description                                                                                                                                                                                                          | Example                                                                                                                                                                                                              |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `architecture`                                                                                                                                                                                                       | [components.ModelArchitecture](../components/modelarchitecture.md)                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                                   | Model architecture information                                                                                                                                                                                       | {<br/>"input_modalities": [<br/>"text"<br/>],<br/>"instruct_type": "chatml",<br/>"modality": "text-\u003etext",<br/>"output_modalities": [<br/>"text"<br/>],<br/>"tokenizer": "GPT"<br/>}                            |
+| `benchmarks`                                                                                                                                                                                                         | [Optional[components.ModelBenchmarks]](../components/modelbenchmarks.md)                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                   | Third-party benchmark rankings for this model. Omitted when no benchmark data is available.                                                                                                                          | {<br/>"artificial_analysis": {<br/>"agentic_index": 55.8,<br/>"coding_index": 63.2,<br/>"intelligence_index": 71.4<br/>},<br/>"design_arena": [<br/>{<br/>"arena": "models",<br/>"category": "website",<br/>"elo": 1385.2,<br/>"rank": 5,<br/>"win_rate": 62.5<br/>}<br/>]<br/>} |
+| `canonical_slug`                                                                                                                                                                                                     | *str*                                                                                                                                                                                                                | :heavy_check_mark:                                                                                                                                                                                                   | Canonical slug for the model                                                                                                                                                                                         | openai/gpt-4                                                                                                                                                                                                         |
+| `context_length`                                                                                                                                                                                                     | *Nullable[int]*                                                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                                                                   | Maximum context length in tokens                                                                                                                                                                                     | 8192                                                                                                                                                                                                                 |
+| `created`                                                                                                                                                                                                            | *int*                                                                                                                                                                                                                | :heavy_check_mark:                                                                                                                                                                                                   | Unix timestamp of when the model was created                                                                                                                                                                         | 1692901234                                                                                                                                                                                                           |
+| `default_parameters`                                                                                                                                                                                                 | [Nullable[components.DefaultParameters]](../components/defaultparameters.md)                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                                   | Default parameters for this model                                                                                                                                                                                    | {<br/>"frequency_penalty": 0,<br/>"presence_penalty": 0,<br/>"repetition_penalty": 1,<br/>"temperature": 0.7,<br/>"top_k": 0,<br/>"top_p": 0.9<br/>}                                                                 |
+| `description`                                                                                                                                                                                                        | *Optional[str]*                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                   | Description of the model                                                                                                                                                                                             | GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.                                                                                                                           |
+| `expiration_date`                                                                                                                                                                                                    | *OptionalNullable[str]*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                   | The date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration.                                                                                                           | 2025-06-01                                                                                                                                                                                                           |
+| `hugging_face_id`                                                                                                                                                                                                    | *OptionalNullable[str]*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                   | Hugging Face model identifier, if applicable                                                                                                                                                                         | microsoft/DialoGPT-medium                                                                                                                                                                                            |
+| `id`                                                                                                                                                                                                                 | *str*                                                                                                                                                                                                                | :heavy_check_mark:                                                                                                                                                                                                   | Unique identifier for the model                                                                                                                                                                                      | openai/gpt-4                                                                                                                                                                                                         |
+| `knowledge_cutoff`                                                                                                                                                                                                   | *OptionalNullable[str]*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                   | The date up to which the model was trained on data. ISO 8601 date string (YYYY-MM-DD) or null if unknown.                                                                                                            | 2024-10-01                                                                                                                                                                                                           |
+| `links`                                                                                                                                                                                                              | [components.ModelLinks](../components/modellinks.md)                                                                                                                                                                 | :heavy_check_mark:                                                                                                                                                                                                   | Related API endpoints and resources for this model.                                                                                                                                                                  | {<br/>"details": "/api/v1/models/openai/gpt-5.4/endpoints"<br/>}                                                                                                                                                     |
+| `name`                                                                                                                                                                                                               | *str*                                                                                                                                                                                                                | :heavy_check_mark:                                                                                                                                                                                                   | Display name of the model                                                                                                                                                                                            | GPT-4                                                                                                                                                                                                                |
+| `per_request_limits`                                                                                                                                                                                                 | [Nullable[components.PerRequestLimits]](../components/perrequestlimits.md)                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                                   | Per-request token limits                                                                                                                                                                                             | {<br/>"completion_tokens": 1000,<br/>"prompt_tokens": 1000<br/>}                                                                                                                                                     |
+| `pricing`                                                                                                                                                                                                            | [components.PublicPricing](../components/publicpricing.md)                                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                                   | Pricing information for the model                                                                                                                                                                                    | {<br/>"completion": "0.00006",<br/>"image": "0",<br/>"prompt": "0.00003",<br/>"request": "0"<br/>}                                                                                                                   |
+| `reasoning`                                                                                                                                                                                                          | [Optional[components.ModelReasoning]](../components/modelreasoning.md)                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                                   | Reasoning effort configuration. Omitted for non-reasoning models and dynamic router models.                                                                                                                          | {<br/>"default_effort": "medium",<br/>"default_enabled": true,<br/>"mandatory": false,<br/>"supported_efforts": [<br/>"high",<br/>"medium",<br/>"low",<br/>"minimal"<br/>]<br/>}                                     |
+| `supported_parameters`                                                                                                                                                                                               | List[[components.Parameter](../components/parameter.md)]                                                                                                                                                             | :heavy_check_mark:                                                                                                                                                                                                   | List of supported parameters for this model                                                                                                                                                                          |                                                                                                                                                                                                                      |
+| `supported_voices`                                                                                                                                                                                                   | List[*str*]                                                                                                                                                                                                          | :heavy_check_mark:                                                                                                                                                                                                   | List of supported voice identifiers for TTS models. Null for non-TTS models.                                                                                                                                         | <nil>                                                                                                                                                                                                                |
+| `top_provider`                                                                                                                                                                                                       | [components.TopProviderInfo](../components/topproviderinfo.md)                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                                                                   | Information about the top provider for this model                                                                                                                                                                    | {<br/>"context_length": 8192,<br/>"is_moderated": true,<br/>"max_completion_tokens": 4096<br/>}                                                                                                                      |
@@ -7,8 +7,8 @@ Model architecture information

 | Field                                                                                                        | Type                                                                                                         | Required                                                                                                     | Description                                                                                                  | Example                                                                                                      |
 | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
-| `tokenizer`                                                                                                  | [Optional[components.ModelGroup]](../components/modelgroup.md)                                               | :heavy_minus_sign:                                                                                           | Tokenizer type used by the model                                                                             | GPT                                                                                                          |
+| `input_modalities`                                                                                           | List[[components.InputModality](../components/inputmodality.md)]                                             | :heavy_check_mark:                                                                                           | Supported input modalities                                                                                   |                                                                                                              |
 | `instruct_type`                                                                                              | [OptionalNullable[components.ModelArchitectureInstructType]](../components/modelarchitectureinstructtype.md) | :heavy_minus_sign:                                                                                           | Instruction format type                                                                                      | chatml                                                                                                       |
 | `modality`                                                                                                   | *Nullable[str]*                                                                                              | :heavy_check_mark:                                                                                           | Primary modality of the model                                                                                | text->text                                                                                                   |
-| `input_modalities`                                                                                           | List[[components.InputModality](../components/inputmodality.md)]                                             | :heavy_check_mark:                                                                                           | Supported input modalities                                                                                   |                                                                                                              |
-| `output_modalities`                                                                                          | List[[components.OutputModality](../components/outputmodality.md)]                                           | :heavy_check_mark:                                                                                           | Supported output modalities                                                                                  |                                                                                                              |
+| `output_modalities`                                                                                          | List[[components.OutputModality](../components/outputmodality.md)]                                           | :heavy_check_mark:                                                                                           | Supported output modalities                                                                                  |                                                                                                              |
+| `tokenizer`                                                                                                  | [Optional[components.ModelGroup]](../components/modelgroup.md)                                               | :heavy_minus_sign:                                                                                           | Tokenizer type used by the model                                                                             | GPT                                                                                                          |
@@ -13,6 +13,7 @@ Tokenizer type used by the model
 | `GPT`       | GPT         |
 | `CLAUDE`    | Claude      |
 | `GEMINI`    | Gemini      |
+| `GEMMA`     | Gemma       |
 | `GROK`      | Grok        |
 | `COHERE`    | Cohere      |
 | `NOVA`      | Nova        |
--- a/Show More
+++ b/Show More