chore: 🐝 Update SDK - Generate (spec change merged) 0.10.5 (#374 )

Co-authored-by: speakeasybot <bot@speakeasyapi.dev> Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
chore: update OpenAPI spec from monorepo (#373 )
2026-07-31 12:30:30 +08:00 · 2026-06-26 14:41:46 +00:00 · 2026-06-26 14:35:36 +00:00 · 2026-06-26 12:10:48 +00:00 · 2026-06-26 12:04:34 +00:00 · 2026-06-26 00:20:39 +00:00
806 changed files with 117631 additions and 34834 deletions
@@ -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,225 @@
+name: Auto-merge Speakeasy PR
+
+# Called as a follow-up job after Speakeasy Generate (mode: pr). Merges the
+# regen PR opened/updated in the same workflow run so sdk_publish.yaml can run.
+# Prefer branch_name from Generate logs; fall back to run_started_at heuristics.
+# Uses GH_DOCS_SYNC GitHub App token (not a PAT) so merges trigger downstream push.
+
+on:
+  workflow_call:
+    inputs:
+      run_started_at:
+        description: ISO timestamp when the parent Generate workflow run started
+        required: true
+        type: string
+      branch_name:
+        description: Speakeasy regen branch from the parent Generate run (optional)
+        required: false
+        type: string
+        default: ""
+    secrets:
+      GH_DOCS_SYNC_APP_ID:
+        required: true
+      GH_DOCS_SYNC_APP_PRIVATE_KEY:
+        required: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: auto-merge-speakeasy
+  cancel-in-progress: false
+
+jobs:
+  auto-merge:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate GitHub App token
+        id: app-token
+        # actions/create-github-app-token@v3.2.0 (immutable SHA)
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1
+        with:
+          app-id: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+          private-key: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}
+
+      - name: Resolve Speakeasy regen PR
+        id: pr
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          set -euo pipefail
+
+          REPO="${{ github.repository }}"
+          RUN_STARTED="${{ inputs.run_started_at }}"
+          BRANCH="${{ inputs.branch_name }}"
+
+          PR_JSON=$(gh pr list \
+            --repo "$REPO" \
+            --state open \
+            --search "head:speakeasy-sdk-regen-" \
+            --limit 500 \
+            --json number,updatedAt,title,labels,author,headRefName)
+
+          PR_NUM=""
+          if [ -n "$BRANCH" ]; then
+            CANDIDATE=$(echo "$PR_JSON" | jq -r --arg branch "$BRANCH" \
+              '[.[] | select(.headRefName == $branch)] | .[0] // empty')
+            if [ -n "$CANDIDATE" ] && echo "$CANDIDATE" | jq -e '
+              (.headRefName | startswith("speakeasy-sdk-regen-"))
+              and (.title | contains("🐝 Update SDK"))
+              and ([.labels[].name] | any(. == "patch" or . == "minor" or . == "major"))
+              and (.author.is_bot == true)
+            ' > /dev/null; then
+              PR_NUM=$(echo "$CANDIDATE" | jq -r '.number')
+              echo "Resolved Speakeasy regen PR #$PR_NUM from branch $BRANCH"
+            else
+              echo "::warning::branch_name=$BRANCH did not match a valid open regen PR — falling back to run_started_at"
+            fi
+          fi
+
+          if [ -z "$PR_NUM" ]; then
+            PR_NUM=$(echo "$PR_JSON" | jq -r --arg started "$RUN_STARTED" '
+              [.[]
+                | select(.headRefName | startswith("speakeasy-sdk-regen-"))
+                | select(.title | contains("🐝 Update SDK"))
+                | select([.labels[].name] | any(. == "patch" or . == "minor" or . == "major"))
+                | select(.author.is_bot == true)
+                | select(.updatedAt >= $started)
+              ] | sort_by(.updatedAt) | last | .number // empty')
+          fi
+
+          if [ -z "$PR_NUM" ]; then
+            echo "No Speakeasy regen PR for this Generate run — skipping auto-merge"
+            echo "::notice title=auto-merge-skipped::No qualifying Speakeasy regen PR to merge"
+            {
+              echo "## Auto-merge skipped"
+              echo "No qualifying \`speakeasy-sdk-regen-*\` PR was found."
+              echo "- branch_name input: \`${BRANCH:-<empty>}\`"
+              echo "- run_started_at: \`$RUN_STARTED\`"
+            } >> "$GITHUB_STEP_SUMMARY"
+            echo "pr_num=" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "pr_num=$PR_NUM" >> "$GITHUB_OUTPUT"
+          echo "$PR_JSON" > /tmp/speakeasy_pr_json.json
+
+      - name: Close superseded Speakeasy PRs
+        if: steps.pr.outputs.pr_num != ''
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          set -euo pipefail
+
+          CURRENT_PR="${{ steps.pr.outputs.pr_num }}"
+          PR_JSON=$(cat /tmp/speakeasy_pr_json.json)
+
+          PRIOR_JSON=$(echo "$PR_JSON" | jq -r --arg current_pr "$CURRENT_PR" \
+            '[.[].number | select(tostring != $current_pr)] | .[]')
+
+          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
+        if: steps.pr.outputs.pr_num != ''
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          set -euo pipefail
+
+          PR_NUM="${{ steps.pr.outputs.pr_num }}"
+          REPO="${{ github.repository }}"
+
+          wait_for_checks() {
+            local pr=$1
+            local timeout=600
+            local interval=15
+            local elapsed=0
+
+            echo "Waiting for PR #$pr checks (timeout ${timeout}s)..."
+            while [ "$elapsed" -lt "$timeout" ]; do
+              TOTAL=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '.statusCheckRollup | length')
+              PENDING=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '[.statusCheckRollup[]? | select(.status != "COMPLETED")] | length')
+              FAILED=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '[.statusCheckRollup[]? | select(.status == "COMPLETED") | select(.conclusion != "SUCCESS" and .conclusion != "SKIPPED" and .conclusion != "NEUTRAL")] | length')
+
+              if [ "$TOTAL" -eq 0 ]; then
+                # GITHUB_TOKEN-authored regen PRs get no pull_request checks at all,
+                # so TOTAL stays 0 forever. Wait a short grace window in case checks
+                # are merely slow to register, then proceed rather than time out.
+                if [ "$elapsed" -ge 60 ]; then
+                  echo "No checks registered after ${elapsed}s — proceeding (checkless PR)"
+                  return 0
+                fi
+                echo "Checks not yet registered — waiting ${interval}s..."
+                sleep "$interval"
+                elapsed=$((elapsed + interval))
+                continue
+              fi
+
+              if [ "$PENDING" -eq 0 ]; then
+                if [ "$FAILED" -gt 0 ]; then
+                  echo "::error::PR #$pr has failing checks — refusing direct merge"
+                  gh pr checks "$pr" --repo "$REPO" || true
+                  exit 1
+                fi
+                echo "All checks completed"
+                return 0
+              fi
+
+              echo "Checks pending ($PENDING) — waiting ${interval}s..."
+              sleep "$interval"
+              elapsed=$((elapsed + interval))
+            done
+
+            echo "::error::Timed out waiting for PR #$pr checks"
+            exit 1
+          }
+
+          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
+
+          MERGE_METHOD=""
+          # Prefer GitHub auto-merge when required checks exist; otherwise
+          # squash-merge directly after checks pass (sdk-release-prs.yaml pattern).
+          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
+            MERGE_METHOD="auto-merge queued"
+            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 — waiting for checks, then merging PR #$PR_NUM directly"
+            cat /tmp/gh-merge.err >&2
+            wait_for_checks "$PR_NUM"
+            gh pr merge "$PR_NUM" --repo "$REPO" --squash --delete-branch
+            MERGE_METHOD="direct squash (checks passed)"
+          else
+            echo "::error::Failed to enable auto-merge on Speakeasy PR #$PR_NUM"
+            cat /tmp/gh-merge.err >&2
+            exit 1
+          fi
+
+          echo "::notice title=auto-merge-pr::Merged Speakeasy PR #$PR_NUM ($MERGE_METHOD)"
+          {
+            echo "## Auto-merge complete"
+            echo "- PR: #$PR_NUM"
+            echo "- Method: $MERGE_METHOD"
+            echo "- Token: GH_DOCS_SYNC GitHub App"
+          } >> "$GITHUB_STEP_SUMMARY"
@@ -0,0 +1,37 @@
+name: PR Validation
+
+on:
+  pull_request:
+    paths-ignore:
+      - .speakeasy/in.openapi.yaml
+
+concurrency:
+  group: pr-validation-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build SDK
+        run: uv build
+
+      - name: Type check (mypy)
+        run: uv run --group dev mypy src
+
+      - name: Type check (pyright)
+        run: uv run --group dev pyright src
+
+      - name: Lint (pylint)
+        run: uv run --group dev pylint src --rcfile pylintrc
@@ -21,6 +21,11 @@ permissions:
    types:
      - labeled
      - unlabeled
+
+concurrency:
+  group: speakeasy-generate
+  cancel-in-progress: false
+
 jobs:
  generate:
    uses: speakeasy-api/sdk-generation-action/.github/workflows/workflow-executor.yaml@v15
@@ -32,3 +37,67 @@ jobs:
      github_access_token: ${{ secrets.GITHUB_TOKEN }}
      pypi_token: ${{ secrets.PYPI_TOKEN }}
      speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
+
+  resolve-branch:
+    needs: generate
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    runs-on: ubuntu-latest
+    outputs:
+      branch_name: ${{ steps.branch.outputs.branch_name }}
+      run_started_at: ${{ steps.branch.outputs.run_started_at }}
+    steps:
+      - name: Extract branch from Generate logs
+        id: branch
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          REPO="${{ github.repository }}"
+          RUN_ID="${{ github.run_id }}"
+
+          RUN_STARTED="${{ github.run_started_at }}"
+          if [ -z "$RUN_STARTED" ]; then
+            RUN_STARTED=$(gh run view "$RUN_ID" --repo "$REPO" --json startedAt --jq '.startedAt')
+            echo "Resolved run_started_at from API: $RUN_STARTED"
+          fi
+          echo "run_started_at=$RUN_STARTED" >> "$GITHUB_OUTPUT"
+
+          # Full-run logs are unavailable while the workflow is in progress;
+          # fetch logs from the completed generate job instead.
+          JOB_ID=$(gh run view "$RUN_ID" --repo "$REPO" --json jobs --jq \
+            '[.jobs[] | select(.name == "generate / Generate Target")] | .[0].databaseId // empty')
+
+          BRANCH=""
+          if [ -z "$JOB_ID" ]; then
+            echo "::warning::Could not find generate job id — auto-merge will use run_started_at fallback"
+          else
+            MAX_ATTEMPTS=12
+            INTERVAL=10
+            for attempt in $(seq 1 "$MAX_ATTEMPTS"); do
+              BRANCH=$(gh run view "$RUN_ID" --repo "$REPO" --job "$JOB_ID" --log 2>/dev/null \
+                | grep -oE 'branch_name=speakeasy-sdk-regen-[0-9]+' | tail -1 | cut -d= -f2 || true)
+              if [ -n "$BRANCH" ]; then
+                echo "Extracted branch_name=$BRANCH (attempt $attempt)"
+                break
+              fi
+              if [ "$attempt" -lt "$MAX_ATTEMPTS" ]; then
+                echo "Job logs not ready — waiting ${INTERVAL}s (attempt $attempt/$MAX_ATTEMPTS)..."
+                sleep "$INTERVAL"
+              fi
+            done
+            if [ -z "$BRANCH" ]; then
+              echo "::warning::Could not extract branch_name from Generate logs after ${MAX_ATTEMPTS} attempts — auto-merge will use run_started_at fallback"
+            fi
+          fi
+          echo "branch_name=$BRANCH" >> "$GITHUB_OUTPUT"
+
+  auto-merge:
+    needs: [generate, resolve-branch]
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    uses: ./.github/workflows/auto-merge-speakeasy-pr.yaml
+    with:
+      run_started_at: ${{ needs.resolve-branch.outputs.run_started_at }}
+      branch_name: ${{ needs.resolve-branch.outputs.branch_name }}
+    secrets:
+      GH_DOCS_SYNC_APP_ID: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+      GH_DOCS_SYNC_APP_PRIVATE_KEY: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}
@@ -0,0 +1,104 @@
+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
+
+concurrency:
+  group: speakeasy-generate-spec-change
+  cancel-in-progress: false
+
+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 }}
+
+  resolve-branch:
+    needs: generate
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    runs-on: ubuntu-latest
+    outputs:
+      branch_name: ${{ steps.branch.outputs.branch_name }}
+      run_started_at: ${{ steps.branch.outputs.run_started_at }}
+    steps:
+      - name: Extract branch from Generate logs
+        id: branch
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          REPO="${{ github.repository }}"
+          RUN_ID="${{ github.run_id }}"
+
+          RUN_STARTED="${{ github.run_started_at }}"
+          if [ -z "$RUN_STARTED" ]; then
+            RUN_STARTED=$(gh run view "$RUN_ID" --repo "$REPO" --json startedAt --jq '.startedAt')
+            echo "Resolved run_started_at from API: $RUN_STARTED"
+          fi
+          echo "run_started_at=$RUN_STARTED" >> "$GITHUB_OUTPUT"
+
+          # Full-run logs are unavailable while the workflow is in progress;
+          # fetch logs from the completed generate job instead.
+          JOB_ID=$(gh run view "$RUN_ID" --repo "$REPO" --json jobs --jq \
+            '[.jobs[] | select(.name == "generate / Generate Target")] | .[0].databaseId // empty')
+
+          BRANCH=""
+          if [ -z "$JOB_ID" ]; then
+            echo "::warning::Could not find generate job id — auto-merge will use run_started_at fallback"
+          else
+            MAX_ATTEMPTS=12
+            INTERVAL=10
+            for attempt in $(seq 1 "$MAX_ATTEMPTS"); do
+              BRANCH=$(gh run view "$RUN_ID" --repo "$REPO" --job "$JOB_ID" --log 2>/dev/null \
+                | grep -oE 'branch_name=speakeasy-sdk-regen-[0-9]+' | tail -1 | cut -d= -f2 || true)
+              if [ -n "$BRANCH" ]; then
+                echo "Extracted branch_name=$BRANCH (attempt $attempt)"
+                break
+              fi
+              if [ "$attempt" -lt "$MAX_ATTEMPTS" ]; then
+                echo "Job logs not ready — waiting ${INTERVAL}s (attempt $attempt/$MAX_ATTEMPTS)..."
+                sleep "$INTERVAL"
+              fi
+            done
+            if [ -z "$BRANCH" ]; then
+              echo "::warning::Could not extract branch_name from Generate logs after ${MAX_ATTEMPTS} attempts — auto-merge will use run_started_at fallback"
+            fi
+          fi
+          echo "branch_name=$BRANCH" >> "$GITHUB_OUTPUT"
+
+  auto-merge:
+    needs: [generate, resolve-branch]
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    uses: ./.github/workflows/auto-merge-speakeasy-pr.yaml
+    with:
+      run_started_at: ${{ needs.resolve-branch.outputs.run_started_at }}
+      branch_name: ${{ needs.resolve-branch.outputs.branch_name }}
+    secrets:
+      GH_DOCS_SYNC_APP_ID: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+      GH_DOCS_SYNC_APP_PRIVATE_KEY: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}
@@ -32,7 +32,7 @@ generation:
    skipResponseBodyAssertions: false
  preApplyUnionDiscriminators: true
 python:
-  version: 0.8.1
+  version: 0.10.5
  additionalDependencies:
    dev: {}
    main: {}
@@ -59,7 +59,7 @@ python:
  flattenGlobalSecurity: true
  flattenRequests: true
  flatteningOrder: parameters-first
-  forwardCompatibleUnionsByDefault: "tagged-only"
+  forwardCompatibleUnionsByDefault: tagged-only
  imports:
    option: openapi
    paths:
@@ -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
@@ -2,19 +2,20 @@ speakeasyVersion: 1.680.0
 sources:
    OpenRouter API:
        sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:0795e89fdc7634204a5e1c93c441069d7bfb349fc1c7f43a53db24f0803c72fa
-        sourceBlobDigest: sha256:bb920e0d3ed7fb2c204d06aa436d9ce9a3635727d3a6147a7a2798333458d12a
+        sourceRevisionDigest: sha256:8e0c6bba19f6520c31262ec38c7bbc2b4306f5c3b6756f72c1a1ff6788b0d461
+        sourceBlobDigest: sha256:30fef4ab492a2a13d07f2097e3f367a809af921fada21987851ef94a0aadd8a8
        tags:
            - latest
+            - speakeasy-sdk-regen-1782484638
            - 1.0.0
 targets:
    open-router:
        source: OpenRouter API
        sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:0795e89fdc7634204a5e1c93c441069d7bfb349fc1c7f43a53db24f0803c72fa
-        sourceBlobDigest: sha256:bb920e0d3ed7fb2c204d06aa436d9ce9a3635727d3a6147a7a2798333458d12a
+        sourceRevisionDigest: sha256:8e0c6bba19f6520c31262ec38c7bbc2b4306f5c3b6756f72c1a1ff6788b0d461
+        sourceBlobDigest: sha256:30fef4ab492a2a13d07f2097e3f367a809af921fada21987851ef94a0aadd8a8
        codeSamplesNamespace: open-router-python-code-samples
-        codeSamplesRevisionDigest: sha256:c368e0601d6b667625dd99ffcd53e69e3dc98a4b518a45444add6457dde83b22
+        codeSamplesRevisionDigest: sha256:a1cd95b23206ce8853cb86f1fc5973931fa1610283db935130345a03c7b8bd51
 workflow:
    workflowVersion: 1.0.0
    speakeasyVersion: 1.680.0
@@ -26,6 +27,9 @@ workflow:
                - 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/open-router-chat-completions-api
@@ -10,6 +10,7 @@ sources:
            - 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/open-router-chat-completions-api
@@ -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?

@@ -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

@@ -246,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. 
+   ```
@@ -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

@@ -246,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. 
+   ```
@@ -8,4 +8,74 @@ Based on:
 ### Generated
 - [python v0.0.16] .
 ### Releases
- [PyPI v0.0.16] https://pypi.org/project/openrouter/0.0.16 - .
+- [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-25 21:56:51
+### 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 - .
+
+## 2026-06-25 22:28:38
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.2] .
+### Releases
+- [PyPI v0.10.2] https://pypi.org/project/openrouter/0.10.2 - .
+
+## 2026-06-26 00:15:50
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.3] .
+### Releases
+- [PyPI v0.10.3] https://pypi.org/project/openrouter/0.10.3 - .
+
+## 2026-06-26 12:06:01
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.4] .
+### Releases
+- [PyPI v0.10.4] https://pypi.org/project/openrouter/0.10.4 - .
+
+## 2026-06-26 14:36:56
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.5] .
+### Releases
+- [PyPI v0.10.5] https://pypi.org/project/openrouter/0.10.5 - .
@@ -12,12 +12,10 @@ with OpenRouter(
    api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:

-    res = open_router.beta.responses.send(service_tier="auto", stream=False)
+    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>
@@ -39,12 +37,10 @@ async def main():
        api_key=os.getenv("OPENROUTER_API_KEY", ""),
    ) as open_router:

-        res = await open_router.beta.responses.send_async(service_tier="auto", stream=False)
+        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 @@
-# CompletionTokensDetails
-
-Detailed completion token usage
-
-
-## Fields
-
-| Field                        | Type                         | Required                     | Description                  |
-| ---------------------------- | ---------------------------- | ---------------------------- | ---------------------------- |
-| `reasoning_tokens`           | *OptionalNullable[float]*    | :heavy_minus_sign:           | Tokens used for reasoning    |
-| `audio_tokens`               | *OptionalNullable[float]*    | :heavy_minus_sign:           | Tokens used for audio output |
-| `accepted_prediction_tokens` | *OptionalNullable[float]*    | :heavy_minus_sign:           | Accepted prediction tokens   |
-| `rejected_prediction_tokens` | *OptionalNullable[float]*    | :heavy_minus_sign:           | Rejected prediction tokens   |
@@ -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,10 +0,0 @@
-# Data
-
-Model count data
-
-
-## Fields
-
-| Field                            | Type                             | Required                         | Description                      | Example                          |
-| -------------------------------- | -------------------------------- | -------------------------------- | -------------------------------- | -------------------------------- |
-| `count`                          | *float*                          | :heavy_check_mark:               | Total number of available models | 150                              |
@@ -7,9 +7,9 @@ Default parameters for this model

 | Field                     | Type                      | Required                  | Description               |
 | ------------------------- | ------------------------- | ------------------------- | ------------------------- |
-| `temperature`             | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
-| `top_p`                   | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
-| `top_k`                   | *OptionalNullable[int]*   | :heavy_minus_sign:        | N/A                       |
 | `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                       |
+| `repetition_penalty`      | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `temperature`             | *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,15 +0,0 @@
-# Effort
-
-Constrains effort on reasoning for reasoning models
-
-
-## Values
-
-| Name      | Value     |
-| --------- | --------- |
-| `XHIGH`   | xhigh     |
-| `HIGH`    | high      |
-| `MEDIUM`  | medium    |
-| `LOW`     | low       |
-| `MINIMAL` | minimal   |
-| `NONE`    | none      |
@@ -1,11 +0,0 @@
-# Error
-
-Error information
-
-
-## Fields
-
-| Field               | Type                | Required            | Description         | Example             |
-| ------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
-| `message`           | *str*               | :heavy_check_mark:  | Error message       | Rate limit exceeded |
-| `code`              | *float*             | :heavy_check_mark:  | Error code          | 429                 |
@@ -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                                                      |
@@ -5,4 +5,4 @@

 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `cached_tokens`    | *float*            | :heavy_check_mark: | N/A                |
+| `cached_tokens`    | *int*              | :heavy_check_mark: | 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                                                                                                                                             |
@@ -5,20 +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/>"top_k": 0,<br/>"frequency_penalty": 0,<br/>"presence_penalty": 0,<br/>"repetition_penalty": 1<br/>} |
-| `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                                                                                                                                        |
-| `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                                                                                                                                        |
+| 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        |
@@ -5,6 +5,6 @@ Model count data

 ## Fields

-| Field                                    | Type                                     | Required                                 | Description                              | Example                                  |
-| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
-| `data`                                   | [components.Data](../components/data.md) | :heavy_check_mark:                       | Model count data                         | {<br/>"count": 150<br/>}                 |
+| Field                                                                          | Type                                                                           | Required                                                                       | Description                                                                    | Example                                                                        |
+| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| `data`                                                                         | [components.ModelsCountResponseData](../components/modelscountresponsedata.md) | :heavy_check_mark:                                                             | Model count data                                                               | {<br/>"count": 150<br/>}                                                       |
@@ -5,6 +5,6 @@ List of available models

 ## Fields

-| Field                                            | Type                                             | Required                                         | Description                                      |
-| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
-| `data`                                           | List[[components.Model](../components/model.md)] | :heavy_check_mark:                               | List of available models                         |
+| Field                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Required                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `data`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | List[[components.Model](../components/model.md)]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | List of available models                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | [<br/>{<br/>"architecture": {<br/>"input_modalities": [<br/>"text"<br/>],<br/>"instruct_type": "chatml",<br/>"modality": "text-\u003etext",<br/>"output_modalities": [<br/>"text"<br/>],<br/>"tokenizer": "GPT"<br/>},<br/>"canonical_slug": "openai/gpt-4",<br/>"context_length": 8192,<br/>"created": 1692901234,<br/>"default_parameters": null,<br/>"description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.",<br/>"expiration_date": null,<br/>"id": "openai/gpt-4",<br/>"knowledge_cutoff": null,<br/>"links": {<br/>"details": "/api/v1/models/openai/gpt-5.4/endpoints"<br/>},<br/>"name": "GPT-4",<br/>"per_request_limits": null,<br/>"pricing": {<br/>"completion": "0.00006",<br/>"image": "0",<br/>"prompt": "0.00003",<br/>"request": "0"<br/>},<br/>"supported_parameters": [<br/>"temperature",<br/>"top_p",<br/>"max_tokens"<br/>],<br/>"supported_voices": null,<br/>"top_provider": {<br/>"context_length": 8192,<br/>"is_moderated": true,<br/>"max_completion_tokens": 4096<br/>}<br/>}<br/>] |
@@ -5,5 +5,5 @@

 | Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
 | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `type`                                                                                             | [components.OpenAIResponsesRefusalContentType](../components/openairesponsesrefusalcontenttype.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
-| `refusal`                                                                                          | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `refusal`                                                                                          | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `type`                                                                                             | [components.OpenAIResponsesRefusalContentType](../components/openairesponsesrefusalcontenttype.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
@@ -5,5 +5,5 @@

 | Field                                                                                                      | Type                                                                                                       | Required                                                                                                   | Description                                                                                                |
 | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `type`                                                                                                     | [components.OpenAIResponsesToolChoiceTypeFunction](../components/openairesponsestoolchoicetypefunction.md) | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
-| `name`                                                                                                     | *str*                                                                                                      | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
+| `name`                                                                                                     | *str*                                                                                                      | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
+| `type`                                                                                                     | [components.OpenAIResponsesToolChoiceTypeFunction](../components/openairesponsestoolchoicetypefunction.md) | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
@@ -33,3 +33,21 @@ value: components.OpenAIResponsesToolChoiceFunction = /* values here */
 value: components.OpenAIResponsesToolChoice = /* values here */
 ```

+### `components.ToolChoiceAllowed`
+
+```python
+value: components.ToolChoiceAllowed = /* values here */
+```
+
+### `components.OpenAIResponsesToolChoiceApplyPatch`
+
+```python
+value: components.OpenAIResponsesToolChoiceApplyPatch = /* values here */
+```
+
+### `components.OpenAIResponsesToolChoiceShell`
+
+```python
+value: components.OpenAIResponsesToolChoiceShell = /* values here */
+```
+
@@ -5,7 +5,7 @@

 | Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        | Example                                                                                            |
 | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `type`                                                                                             | [components.OutputItemImageGenerationCallType](../components/outputitemimagegenerationcalltype.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |                                                                                                    |
 | `id`                                                                                               | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |                                                                                                    |
 | `result`                                                                                           | *OptionalNullable[str]*                                                                            | :heavy_minus_sign:                                                                                 | N/A                                                                                                |                                                                                                    |
-| `status`                                                                                           | [components.ImageGenerationStatus](../components/imagegenerationstatus.md)                         | :heavy_check_mark:                                                                                 | N/A                                                                                                | completed                                                                                          |
+| `status`                                                                                           | [components.ImageGenerationStatus](../components/imagegenerationstatus.md)                         | :heavy_check_mark:                                                                                 | N/A                                                                                                | completed                                                                                          |
+| `type`                                                                                             | [components.OutputItemImageGenerationCallType](../components/outputitemimagegenerationcalltype.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |                                                                                                    |
@@ -5,9 +5,9 @@

 | Field                                                                                                                                                                                                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                   | Required                                                                                                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                            |
 | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`                                                                                                                                                                                                                                                                                                                                   | *str*                                                                                                                                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
-| `role`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageRole](../components/outputmessagerole.md)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
-| `type`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageType](../components/outputmessagetype.md)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
-| `status`                                                                                                                                                                                                                                                                                                                               | [Optional[components.OutputMessageStatusUnion]](../components/outputmessagestatusunion.md)                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
 | `content`                                                                                                                                                                                                                                                                                                                              | List[[components.OutputMessageContent](../components/outputmessagecontent.md)]                                                                                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
-| `phase`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.OutputMessagePhaseUnion]](../components/outputmessagephaseunion.md)                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | The phase of an assistant message. Use `commentary` for an intermediate assistant message and `final_answer` for the final assistant message. For follow-up requests with models like `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages. Omitting it can degrade performance. Not used for user messages. |
+| `id`                                                                                                                                                                                                                                                                                                                                   | *str*                                                                                                                                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
+| `phase`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.OutputMessagePhaseUnion]](../components/outputmessagephaseunion.md)                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | The phase of an assistant message. Use `commentary` for an intermediate assistant message and `final_answer` for the final assistant message. For follow-up requests with models like `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages. Omitting it can degrade performance. Not used for user messages. |
+| `role`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageRole](../components/outputmessagerole.md)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
+| `status`                                                                                                                                                                                                                                                                                                                               | [Optional[components.OutputMessageStatusUnion]](../components/outputmessagestatusunion.md)                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
+| `type`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageType](../components/outputmessagetype.md)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
@@ -3,10 +3,13 @@

 ## Values

-| Name         | Value        |
-| ------------ | ------------ |
-| `TEXT`       | text         |
-| `IMAGE`      | image        |
-| `EMBEDDINGS` | embeddings   |
-| `AUDIO`      | audio        |
-| `VIDEO`      | video        |
+| Name            | Value           |
+| --------------- | --------------- |
+| `TEXT`          | text            |
+| `IMAGE`         | image           |
+| `EMBEDDINGS`    | embeddings      |
+| `AUDIO`         | audio           |
+| `VIDEO`         | video           |
+| `RERANK`        | rerank          |
+| `SPEECH`        | speech          |
+| `TRANSCRIPTION` | transcription   |
@@ -5,4 +5,4 @@

 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `reasoning_tokens` | *float*            | :heavy_check_mark: | N/A                |
+| `reasoning_tokens` | *int*              | :heavy_check_mark: | N/A                |
@@ -3,29 +3,30 @@

 ## Values

-| Name                  | Value                 |
-| --------------------- | --------------------- |
-| `TEMPERATURE`         | temperature           |
-| `TOP_P`               | top_p                 |
-| `TOP_K`               | top_k                 |
-| `MIN_P`               | min_p                 |
-| `TOP_A`               | top_a                 |
-| `FREQUENCY_PENALTY`   | frequency_penalty     |
-| `PRESENCE_PENALTY`    | presence_penalty      |
-| `REPETITION_PENALTY`  | repetition_penalty    |
-| `MAX_TOKENS`          | max_tokens            |
-| `LOGIT_BIAS`          | logit_bias            |
-| `LOGPROBS`            | logprobs              |
-| `TOP_LOGPROBS`        | top_logprobs          |
-| `SEED`                | seed                  |
-| `RESPONSE_FORMAT`     | response_format       |
-| `STRUCTURED_OUTPUTS`  | structured_outputs    |
-| `STOP`                | stop                  |
-| `TOOLS`               | tools                 |
-| `TOOL_CHOICE`         | tool_choice           |
-| `PARALLEL_TOOL_CALLS` | parallel_tool_calls   |
-| `INCLUDE_REASONING`   | include_reasoning     |
-| `REASONING`           | reasoning             |
-| `REASONING_EFFORT`    | reasoning_effort      |
-| `WEB_SEARCH_OPTIONS`  | web_search_options    |
-| `VERBOSITY`           | verbosity             |
+| Name                    | Value                   |
+| ----------------------- | ----------------------- |
+| `TEMPERATURE`           | temperature             |
+| `TOP_P`                 | top_p                   |
+| `TOP_K`                 | top_k                   |
+| `MIN_P`                 | min_p                   |
+| `TOP_A`                 | top_a                   |
+| `FREQUENCY_PENALTY`     | frequency_penalty       |
+| `PRESENCE_PENALTY`      | presence_penalty        |
+| `REPETITION_PENALTY`    | repetition_penalty      |
+| `MAX_TOKENS`            | max_tokens              |
+| `MAX_COMPLETION_TOKENS` | max_completion_tokens   |
+| `LOGIT_BIAS`            | logit_bias              |
+| `LOGPROBS`              | logprobs                |
+| `TOP_LOGPROBS`          | top_logprobs            |
+| `SEED`                  | seed                    |
+| `RESPONSE_FORMAT`       | response_format         |
+| `STRUCTURED_OUTPUTS`    | structured_outputs      |
+| `STOP`                  | stop                    |
+| `TOOLS`                 | tools                   |
+| `TOOL_CHOICE`           | tool_choice             |
+| `PARALLEL_TOOL_CALLS`   | parallel_tool_calls     |
+| `INCLUDE_REASONING`     | include_reasoning       |
+| `REASONING`             | reasoning               |
+| `REASONING_EFFORT`      | reasoning_effort        |
+| `WEB_SEARCH_OPTIONS`    | web_search_options      |
+| `VERBOSITY`             | verbosity               |
@@ -5,6 +5,6 @@ Options for PDF parsing.

 ## Fields

-| Field                                                                                                              | Type                                                                                                               | Required                                                                                                           | Description                                                                                                        |
-| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
-| `engine`                                                                                                           | [Optional[components.PDFParserEngine]](../components/pdfparserengine.md)                                           | :heavy_minus_sign:                                                                                                 | The engine to use for parsing PDF files. "pdf-text" is deprecated and automatically redirected to "cloudflare-ai". |
+| Field                                                                                                              | Type                                                                                                               | Required                                                                                                           | Description                                                                                                        | Example                                                                                                            |
+| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
+| `engine`                                                                                                           | [Optional[components.PDFParserEngine]](../components/pdfparserengine.md)                                           | :heavy_minus_sign:                                                                                                 | The engine to use for parsing PDF files. "pdf-text" is deprecated and automatically redirected to "cloudflare-ai". | cloudflare-ai                                                                                                      |
@@ -7,5 +7,5 @@ Per-request token limits

 | Field                                 | Type                                  | Required                              | Description                           | Example                               |
 | ------------------------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------- |
-| `prompt_tokens`                       | *float*                               | :heavy_check_mark:                    | Maximum prompt tokens per request     | 1000                                  |
-| `completion_tokens`                   | *float*                               | :heavy_check_mark:                    | Maximum completion tokens per request | 1000                                  |
+| `completion_tokens`                   | *float*                               | :heavy_check_mark:                    | Maximum completion tokens per request | 1000                                  |
+| `prompt_tokens`                       | *float*                               | :heavy_check_mark:                    | Maximum prompt tokens per request     | 1000                                  |
@@ -3,19 +3,20 @@

 ## Fields

-| Field                | Type                 | Required             | Description          | Example              |
-| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- |
-| `prompt`             | *str*                | :heavy_check_mark:   | N/A                  | 1000                 |
-| `completion`         | *str*                | :heavy_check_mark:   | N/A                  | 1000                 |
-| `request`            | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image`              | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image_token`        | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image_output`       | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `audio`              | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `audio_output`       | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_audio_cache`  | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `web_search`         | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `internal_reasoning` | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_cache_read`   | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_cache_write`  | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `discount`           | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |                      |
+| Field                                                                                                                                                     | Type                                                                                                                                                      | Required                                                                                                                                                  | Description                                                                                                                                               |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `audio`                                                                                                                                                   | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per audio input token                                                                                                                        |
+| `audio_output`                                                                                                                                            | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per audio output token                                                                                                                       |
+| `completion`                                                                                                                                              | *str*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                        | Price in USD per token for completion (output) generation                                                                                                 |
+| `discount`                                                                                                                                                | *Optional[float]*                                                                                                                                         | :heavy_minus_sign:                                                                                                                                        | Fractional discount applied to this endpoint's pricing; the price is multiplied by (1 - discount) (0 = no discount, 1 = free)                             |
+| `image`                                                                                                                                                   | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per input image                                                                                                                              |
+| `image_output`                                                                                                                                            | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per output image                                                                                                                             |
+| `image_token`                                                                                                                                             | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per image token                                                                                                                              |
+| `input_audio_cache`                                                                                                                                       | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per cached audio input token                                                                                                                 |
+| `input_cache_read`                                                                                                                                        | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per cached input token (read)                                                                                                                |
+| `input_cache_write`                                                                                                                                       | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price per cache-write token, in USD per token. For providers with multiple cache TTLs (e.g. Anthropic), this is the default (5-minute) cache-write rate.  |
+| `input_cache_write_1h`                                                                                                                                    | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price per 1-hour cache-write token, in USD per token. Only present for providers that price an extended (1-hour) cache TTL separately, such as Anthropic. |
+| `internal_reasoning`                                                                                                                                      | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per internal reasoning token                                                                                                                 |
+| `prompt`                                                                                                                                                  | *str*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                        | Price in USD per token for prompt (input) processing                                                                                                      |
+| `request`                                                                                                                                                 | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per request                                                                                                                                  |
+| `web_search`                                                                                                                                              | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per web search                                                                                                                               |
@@ -1,13 +0,0 @@
-# PromptTokensDetails
-
-Detailed prompt token usage
-
-
-## Fields
-
-| Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      |
-| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
-| `cached_tokens`                                                                                  | *Optional[float]*                                                                                | :heavy_minus_sign:                                                                               | Cached prompt tokens                                                                             |
-| `cache_write_tokens`                                                                             | *Optional[float]*                                                                                | :heavy_minus_sign:                                                                               | Tokens written to cache. Only returned for models with explicit caching and cache write pricing. |
-| `audio_tokens`                                                                                   | *Optional[float]*                                                                                | :heavy_minus_sign:                                                                               | Audio input tokens                                                                               |
-| `video_tokens`                                                                                   | *Optional[float]*                                                                                | :heavy_minus_sign:                                                                               | Video input tokens                                                                               |
@@ -10,6 +10,7 @@
 | `AION_LABS`         | AionLabs            |
 | `ALIBABA`           | Alibaba             |
 | `AMBIENT`           | Ambient             |
+| `BAIDU`             | Baidu               |
 | `AMAZON_BEDROCK`    | Amazon Bedrock      |
 | `AMAZON_NOVA`       | Amazon Nova         |
 | `ANTHROPIC`         | Anthropic           |
@@ -26,9 +27,14 @@
 | `CLARIFAI`          | Clarifai            |
 | `CLOUDFLARE`        | Cloudflare          |
 | `COHERE`            | Cohere              |
+| `CRUCIBLE`          | Crucible            |
 | `CRUSOE`            | Crusoe              |
+| `DARKBLOOM`         | Darkbloom           |
+| `DECART`            | Decart              |
 | `DEEP_INFRA`        | DeepInfra           |
 | `DEEP_SEEK`         | DeepSeek            |
+| `DEKA_LLM`          | DekaLLM             |
+| `DIGITAL_OCEAN`     | DigitalOcean        |
 | `FEATHERLESS`       | Featherless         |
 | `FIREWORKS`         | Fireworks           |
 | `FRIENDLI`          | Friendli            |
@@ -36,13 +42,14 @@
 | `GOOGLE`            | Google              |
 | `GOOGLE_AI_STUDIO`  | Google AI Studio    |
 | `GROQ`              | Groq                |
-| `HYPERBOLIC`        | Hyperbolic          |
+| `HEY_GEN`           | HeyGen              |
 | `INCEPTION`         | Inception           |
 | `INCEPTRON`         | Inceptron           |
 | `INFERENCE_NET`     | InferenceNet        |
 | `IONSTREAM`         | Ionstream           |
 | `INFERMATIC`        | Infermatic          |
 | `IO_NET`            | Io Net              |
+| `INFERACT_V_LLM`    | Inferact vLLM       |
 | `INFLECTION`        | Inflection          |
 | `LIQUID`            | Liquid              |
 | `MARA`              | Mara                |
@@ -55,16 +62,21 @@
 | `MORPH`             | Morph               |
 | `N_COMPASS`         | NCompass            |
 | `NEBIUS`            | Nebius              |
+| `NEX_AGI`           | Nex AGI             |
 | `NEXT_BIT`          | NextBit             |
 | `NOVITA`            | Novita              |
 | `NVIDIA`            | Nvidia              |
 | `OPEN_AI`           | OpenAI              |
 | `OPEN_INFERENCE`    | OpenInference       |
 | `PARASAIL`          | Parasail            |
+| `POOLSIDE`          | Poolside            |
+| `PERCEPTRON`        | Perceptron          |
 | `PERPLEXITY`        | Perplexity          |
 | `PHALA`             | Phala               |
+| `RECRAFT`           | Recraft             |
 | `REKA`              | Reka                |
 | `RELACE`            | Relace              |
+| `SAKANA_AI`         | Sakana AI           |
 | `SAMBA_NOVA`        | SambaNova           |
 | `SEED`              | Seed                |
 | `SILICON_FLOW`      | SiliconFlow         |
@@ -73,9 +85,11 @@
 | `STEALTH`           | Stealth             |
 | `STREAM_LAKE`       | StreamLake          |
 | `SWITCHPOINT`       | Switchpoint         |
+| `TENSTORRENT`       | Tenstorrent         |
 | `TOGETHER`          | Together            |
 | `UPSTAGE`           | Upstage             |
 | `VENICE`            | Venice              |
+| `WAFER`             | Wafer               |
 | `WAND_B`            | WandB               |
 | `XIAOMI`            | Xiaomi              |
 | `X_AI`              | xAI                 |
@@ -1,6 +1,6 @@
 # ProviderPreferences

-Provider routing preferences for the request.
+When multiple model providers are available, optionally indicate your routing preference.


 ## Fields
@@ -8,15 +8,15 @@ Provider routing preferences for the request.
 | Field                                                                                                                                                                                                                                                                                                                                                     | Type                                                                                                                                                                                                                                                                                                                                                      | Required                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                               | Example                                                                                                                                                                                                                                                                                                                                                   |
 | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `allow_fallbacks`                                                                                                                                                                                                                                                                                                                                         | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to allow backup providers to serve requests<br/>- true: (default) when the primary provider (or your custom providers in "order") is unavailable, use the next best provider.<br/>- false: use only the primary/custom provider, and return the upstream error if it's unavailable.<br/>                                                          |                                                                                                                                                                                                                                                                                                                                                           |
-| `require_parameters`                                                                                                                                                                                                                                                                                                                                      | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to filter providers to only those that support the parameters you've provided. If this setting is omitted or set to false, then providers will receive only the parameters they support, and ignore the rest.                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                           |
 | `data_collection`                                                                                                                                                                                                                                                                                                                                         | [OptionalNullable[components.DataCollection]](../components/datacollection.md)                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Data collection setting. If no available model provider meets the requirement, your request will return an error.<br/>- allow: (default) allow providers which store user data non-transiently and may train on it<br/><br/>- deny: use only providers which do not collect user data.                                                                    | allow                                                                                                                                                                                                                                                                                                                                                     |
-| `zdr`                                                                                                                                                                                                                                                                                                                                                     | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to restrict routing to only ZDR (Zero Data Retention) endpoints. When true, only endpoints that do not retain prompts will be used.                                                                                                                                                                                                               | true                                                                                                                                                                                                                                                                                                                                                      |
 | `enforce_distillable_text`                                                                                                                                                                                                                                                                                                                                | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to restrict routing to only models that allow text distillation. When true, only models where the author has allowed distillation will be used.                                                                                                                                                                                                   | true                                                                                                                                                                                                                                                                                                                                                      |
-| `order`                                                                                                                                                                                                                                                                                                                                                   | List[[components.ProviderPreferencesOrder](../components/providerpreferencesorder.md)]                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | An ordered list of provider slugs. The router will attempt to use the first provider in the subset of this list that supports your requested model, and fall back to the next if it is unavailable. If no providers are available, the request will fail with an error message.                                                                           |                                                                                                                                                                                                                                                                                                                                                           |
-| `only`                                                                                                                                                                                                                                                                                                                                                    | List[[components.ProviderPreferencesOnly](../components/providerpreferencesonly.md)]                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider settings for this request.                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                           |
-| `ignore`                                                                                                                                                                                                                                                                                                                                                  | List[[components.ProviderPreferencesIgnore](../components/providerpreferencesignore.md)]                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | List of provider slugs to ignore. If provided, this list is merged with your account-wide ignored provider settings for this request.                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                           |
-| `quantizations`                                                                                                                                                                                                                                                                                                                                           | List[[components.Quantization](../components/quantization.md)]                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | A list of quantization levels to filter the provider by.                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                           |
-| `sort`                                                                                                                                                                                                                                                                                                                                                    | [OptionalNullable[components.ProviderPreferencesSortUnion]](../components/providerpreferencessortunion.md)                                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | N/A                                                                                                                                                                                                                                                                                                                                                       | price                                                                                                                                                                                                                                                                                                                                                     |
-| `max_price`                                                                                                                                                                                                                                                                                                                                               | [Optional[components.ProviderPreferencesMaxPrice]](../components/providerpreferencesmaxprice.md)                                                                                                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion.                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                           |
+| `ignore`                                                                                                                                                                                                                                                                                                                                                  | List[[components.Ignore](../components/ignore.md)]                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | List of provider slugs to ignore. If provided, this list is merged with your account-wide ignored provider settings for this request.                                                                                                                                                                                                                     | [<br/>"openai",<br/>"anthropic"<br/>]                                                                                                                                                                                                                                                                                                                     |
+| `max_price`                                                                                                                                                                                                                                                                                                                                               | [Optional[components.MaxPrice]](../components/maxprice.md)                                                                                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion.                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                           |
+| `only`                                                                                                                                                                                                                                                                                                                                                    | List[[components.Only](../components/only.md)]                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider settings for this request.                                                                                                                                                                                                                      | [<br/>"openai",<br/>"anthropic"<br/>]                                                                                                                                                                                                                                                                                                                     |
+| `order`                                                                                                                                                                                                                                                                                                                                                   | List[[components.Order](../components/order.md)]                                                                                                                                                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | An ordered list of provider slugs. The router will attempt to use the first provider in the subset of this list that supports your requested model, and fall back to the next if it is unavailable. If no providers are available, the request will fail with an error message.                                                                           | [<br/>"openai",<br/>"anthropic"<br/>]                                                                                                                                                                                                                                                                                                                     |
+| `preferred_max_latency`                                                                                                                                                                                                                                                                                                                                   | [OptionalNullable[components.PreferredMaxLatency]](../components/preferredmaxlatency.md)                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Preferred maximum latency (in seconds). Can be a number (applies to p50) or an object with percentile-specific cutoffs. Endpoints above the threshold(s) may still be used, but are deprioritized in routing. When using fallback models, this may cause a fallback model to be used instead of the primary model if it meets the threshold.              | 5                                                                                                                                                                                                                                                                                                                                                         |
 | `preferred_min_throughput`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.PreferredMinThroughput]](../components/preferredminthroughput.md)                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Preferred minimum throughput (in tokens per second). Can be a number (applies to p50) or an object with percentile-specific cutoffs. Endpoints below the threshold(s) may still be used, but are deprioritized in routing. When using fallback models, this may cause a fallback model to be used instead of the primary model if it meets the threshold. | 100                                                                                                                                                                                                                                                                                                                                                       |
-| `preferred_max_latency`                                                                                                                                                                                                                                                                                                                                   | [OptionalNullable[components.PreferredMaxLatency]](../components/preferredmaxlatency.md)                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Preferred maximum latency (in seconds). Can be a number (applies to p50) or an object with percentile-specific cutoffs. Endpoints above the threshold(s) may still be used, but are deprioritized in routing. When using fallback models, this may cause a fallback model to be used instead of the primary model if it meets the threshold.              | 5                                                                                                                                                                                                                                                                                                                                                         |
+| `quantizations`                                                                                                                                                                                                                                                                                                                                           | List[[components.Quantization](../components/quantization.md)]                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | A list of quantization levels to filter the provider by.                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                           |
+| `require_parameters`                                                                                                                                                                                                                                                                                                                                      | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to filter providers to only those that support the parameters you've provided. If this setting is omitted or set to false, then providers will receive only the parameters they support, and ignore the rest.                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                           |
+| `sort`                                                                                                                                                                                                                                                                                                                                                    | [OptionalNullable[components.Sort]](../components/sort.md)                                                                                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is performed.                                                                                                                                                                                                                                      | price                                                                                                                                                                                                                                                                                                                                                     |
+| `zdr`                                                                                                                                                                                                                                                                                                                                                     | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | Whether to restrict routing to only ZDR (Zero Data Retention) endpoints. When true, only endpoints that do not retain prompts will be used.                                                                                                                                                                                                               | true                                                                                                                                                                                                                                                                                                                                                      |
@@ -1,13 +0,0 @@
-# ProviderPreferencesBy
-
-The provider sorting strategy (price, throughput, latency)
-
-
-## Values
-
-| Name         | Value        |
-| ------------ | ------------ |
-| `PRICE`      | price        |
-| `THROUGHPUT` | throughput   |
-| `LATENCY`    | latency      |
-| `EXACTO`     | exacto       |
@@ -1,17 +0,0 @@
-# ProviderPreferencesIgnore
-
-
-## Supported Types
-
-### `components.ProviderName`
-
-```python
-value: components.ProviderName = /* values here */
-```
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
@@ -1,14 +0,0 @@
-# ProviderPreferencesMaxPrice
-
-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                     | Example                         |
-| ------------------------------- | ------------------------------- | ------------------------------- | ------------------------------- | ------------------------------- |
-| `prompt`                        | *Optional[str]*                 | :heavy_minus_sign:              | Price per million prompt tokens | 1000                            |
-| `completion`                    | *Optional[str]*                 | :heavy_minus_sign:              | N/A                             | 1000                            |
-| `image`                         | *Optional[str]*                 | :heavy_minus_sign:              | N/A                             | 1000                            |
-| `audio`                         | *Optional[str]*                 | :heavy_minus_sign:              | N/A                             | 1000                            |
-| `request`                       | *Optional[str]*                 | :heavy_minus_sign:              | N/A                             | 1000                            |
@@ -1,17 +0,0 @@
-# ProviderPreferencesOnly
-
-
-## Supported Types
-
-### `components.ProviderName`
-
-```python
-value: components.ProviderName = /* values here */
-```
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
@@ -1,17 +0,0 @@
-# ProviderPreferencesOrder
-
-
-## Supported Types
-
-### `components.ProviderName`
-
-```python
-value: components.ProviderName = /* values here */
-```
-
-### `str`
-
-```python
-value: str = /* values here */
-```
-
@@ -1,11 +0,0 @@
-# ProviderPreferencesPartition
-
-Partitioning strategy for sorting: "model" (default) groups endpoints by model before sorting (fallback models remain fallbacks), "none" sorts all endpoints together regardless of model.
-
-
-## Values
-
-| Name    | Value   |
-| ------- | ------- |
-| `MODEL` | model   |
-| `NONE`  | none    |
@@ -1,13 +0,0 @@
-# ProviderPreferencesProviderSort
-
-The provider sorting strategy (price, throughput, latency)
-
-
-## Values
-
-| Name         | Value        |
-| ------------ | ------------ |
-| `PRICE`      | price        |
-| `THROUGHPUT` | throughput   |
-| `LATENCY`    | latency      |
-| `EXACTO`     | exacto       |
@@ -1,9 +0,0 @@
-# ProviderPreferencesProviderSortConfig
-
-
-## Fields
-
-| Field                                                                                                                                                                                      | Type                                                                                                                                                                                       | Required                                                                                                                                                                                   | Description                                                                                                                                                                                | Example                                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `by`                                                                                                                                                                                       | [OptionalNullable[components.ProviderPreferencesBy]](../components/providerpreferencesby.md)                                                                                               | :heavy_minus_sign:                                                                                                                                                                         | The provider sorting strategy (price, throughput, latency)                                                                                                                                 | price                                                                                                                                                                                      |
-| `partition`                                                                                                                                                                                | [OptionalNullable[components.ProviderPreferencesPartition]](../components/providerpreferencespartition.md)                                                                                 | :heavy_minus_sign:                                                                                                                                                                         | Partitioning strategy for sorting: "model" (default) groups endpoints by model before sorting (fallback models remain fallbacks), "none" sorts all endpoints together regardless of model. | model                                                                                                                                                                                      |
@@ -1,11 +0,0 @@
-# ProviderPreferencesProviderSortConfigEnum
-
-
-## Values
-
-| Name         | Value        |
-| ------------ | ------------ |
-| `PRICE`      | price        |
-| `THROUGHPUT` | throughput   |
-| `LATENCY`    | latency      |
-| `EXACTO`     | exacto       |
@@ -1,17 +0,0 @@
-# ProviderPreferencesProviderSortConfigUnion
-
-
-## Supported Types
-
-### `components.ProviderPreferencesProviderSortConfig`
-
-```python
-value: components.ProviderPreferencesProviderSortConfig = /* values here */
-```
-
-### `components.ProviderPreferencesProviderSortConfigEnum`
-
-```python
-value: components.ProviderPreferencesProviderSortConfigEnum = /* values here */
-```
-
@@ -1,11 +0,0 @@
-# ProviderPreferencesSortEnum
-
-
-## Values
-
-| Name         | Value        |
-| ------------ | ------------ |
-| `PRICE`      | price        |
-| `THROUGHPUT` | throughput   |
-| `LATENCY`    | latency      |
-| `EXACTO`     | exacto       |
@@ -1,25 +0,0 @@
-# ProviderPreferencesSortUnion
-
-The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is performed.
-
-
-## Supported Types
-
-### `components.ProviderPreferencesProviderSort`
-
-```python
-value: components.ProviderPreferencesProviderSort = /* values here */
-```
-
-### `components.ProviderPreferencesProviderSortConfigUnion`
-
-```python
-value: components.ProviderPreferencesProviderSortConfigUnion = /* values here */
-```
-
-### `components.ProviderPreferencesSortEnum`
-
-```python
-value: components.ProviderPreferencesSortEnum = /* values here */
-```
-
@@ -7,19 +7,21 @@ Information about a specific model endpoint

 | Field                                                                                                                                                                                                     | Type                                                                                                                                                                                                      | Required                                                                                                                                                                                                  | Description                                                                                                                                                                                               | Example                                                                                                                                                                                                   |
 | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`                                                                                                                                                                                                    | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `context_length`                                                                                                                                                                                          | *int*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `latency_last_30m`                                                                                                                                                                                        | [Nullable[components.PercentileStats]](../components/percentilestats.md)                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | Latency percentiles in milliseconds over the last 30 minutes. Latency measures time to first token. Only visible when authenticated with an API key or cookie; returns null for unauthenticated requests. | {<br/>"p50": 25.5,<br/>"p75": 35.2,<br/>"p90": 48.7,<br/>"p99": 85.3<br/>}                                                                                                                                |
+| `max_completion_tokens`                                                                                                                                                                                   | *Nullable[int]*                                                                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `max_prompt_tokens`                                                                                                                                                                                       | *Nullable[int]*                                                                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `model_id`                                                                                                                                                                                                | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | The unique identifier for the model (permaslug)                                                                                                                                                           | openai/gpt-4                                                                                                                                                                                              |
 | `model_name`                                                                                                                                                                                              | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `context_length`                                                                                                                                                                                          | *float*                                                                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `name`                                                                                                                                                                                                    | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `pricing`                                                                                                                                                                                                 | [components.Pricing](../components/pricing.md)                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `provider_name`                                                                                                                                                                                           | [components.ProviderName](../components/providername.md)                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | OpenAI                                                                                                                                                                                                    |
-| `tag`                                                                                                                                                                                                     | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `quantization`                                                                                                                                                                                            | [Nullable[components.PublicEndpointQuantization]](../components/publicendpointquantization.md)                                                                                                            | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | fp16                                                                                                                                                                                                      |
-| `max_completion_tokens`                                                                                                                                                                                   | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `max_prompt_tokens`                                                                                                                                                                                       | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `supported_parameters`                                                                                                                                                                                    | List[[components.Parameter](../components/parameter.md)]                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `status`                                                                                                                                                                                                  | [Optional[components.EndpointStatus]](../components/endpointstatus.md)                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | 0                                                                                                                                                                                                         |
-| `uptime_last_30m`                                                                                                                                                                                         | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `supported_parameters`                                                                                                                                                                                    | List[[components.Parameter](../components/parameter.md)]                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
 | `supports_implicit_caching`                                                                                                                                                                               | *bool*                                                                                                                                                                                                    | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `latency_last_30m`                                                                                                                                                                                        | [Nullable[components.PercentileStats]](../components/percentilestats.md)                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | Latency percentiles in milliseconds over the last 30 minutes. Latency measures time to first token. Only visible when authenticated with an API key or cookie; returns null for unauthenticated requests. |                                                                                                                                                                                                           |
-| `throughput_last_30m`                                                                                                                                                                                     | [Nullable[components.PercentileStats]](../components/percentilestats.md)                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `tag`                                                                                                                                                                                                     | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `throughput_last_30m`                                                                                                                                                                                     | [Nullable[components.PercentileStats]](../components/percentilestats.md)                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | {<br/>"p50": 25.5,<br/>"p75": 35.2,<br/>"p90": 48.7,<br/>"p99": 85.3<br/>}                                                                                                                                |
+| `uptime_last_1d`                                                                                                                                                                                          | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | Uptime percentage over the last 1 day, calculated as successful requests / (successful + error requests) * 100. Rate-limited requests are excluded. Returns null if insufficient data.                    |                                                                                                                                                                                                           |
+| `uptime_last_30m`                                                                                                                                                                                         | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
+| `uptime_last_5m`                                                                                                                                                                                          | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | Uptime percentage over the last 5 minutes, calculated as successful requests / (successful + error requests) * 100. Rate-limited requests are excluded. Returns null if insufficient data.                |                                                                                                                                                                                                           |
@@ -5,19 +5,20 @@ Pricing information for the model

 ## Fields

-| Field                | Type                 | Required             | Description          | Example              |
-| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- |
-| `prompt`             | *str*                | :heavy_check_mark:   | N/A                  | 1000                 |
-| `completion`         | *str*                | :heavy_check_mark:   | N/A                  | 1000                 |
-| `request`            | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image`              | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image_token`        | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `image_output`       | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `audio`              | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `audio_output`       | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_audio_cache`  | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `web_search`         | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `internal_reasoning` | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_cache_read`   | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `input_cache_write`  | *Optional[str]*      | :heavy_minus_sign:   | N/A                  | 1000                 |
-| `discount`           | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |                      |
+| Field                                                                                                                                                     | Type                                                                                                                                                      | Required                                                                                                                                                  | Description                                                                                                                                               |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `audio`                                                                                                                                                   | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per audio input token                                                                                                                        |
+| `audio_output`                                                                                                                                            | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per audio output token                                                                                                                       |
+| `completion`                                                                                                                                              | *str*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                        | Price in USD per token for completion (output) generation                                                                                                 |
+| `discount`                                                                                                                                                | *Optional[float]*                                                                                                                                         | :heavy_minus_sign:                                                                                                                                        | Fractional discount applied to this endpoint's pricing; the price is multiplied by (1 - discount) (0 = no discount, 1 = free)                             |
+| `image`                                                                                                                                                   | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per input image                                                                                                                              |
+| `image_output`                                                                                                                                            | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per output image                                                                                                                             |
+| `image_token`                                                                                                                                             | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per image token                                                                                                                              |
+| `input_audio_cache`                                                                                                                                       | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per cached audio input token                                                                                                                 |
+| `input_cache_read`                                                                                                                                        | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per cached input token (read)                                                                                                                |
+| `input_cache_write`                                                                                                                                       | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price per cache-write token, in USD per token. For providers with multiple cache TTLs (e.g. Anthropic), this is the default (5-minute) cache-write rate.  |
+| `input_cache_write_1h`                                                                                                                                    | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price per 1-hour cache-write token, in USD per token. Only present for providers that price an extended (1-hour) cache TTL separately, such as Anthropic. |
+| `internal_reasoning`                                                                                                                                      | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per internal reasoning token                                                                                                                 |
+| `prompt`                                                                                                                                                  | *str*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                        | Price in USD per token for prompt (input) processing                                                                                                      |
+| `request`                                                                                                                                                 | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per request                                                                                                                                  |
+| `web_search`                                                                                                                                              | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Price in USD per web search                                                                                                                               |
@@ -1,11 +0,0 @@
-# Reasoning
-
-Configuration options for reasoning models
-
-
-## Fields
-
-| Field                                                          | Type                                                           | Required                                                       | Description                                                    | Example                                                        |
-| -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
-| `effort`                                                       | [OptionalNullable[components.Effort]](../components/effort.md) | :heavy_minus_sign:                                             | Constrains effort on reasoning for reasoning models            | medium                                                         |
-| `summary`                                                      | *OptionalNullable[Any]*                                        | :heavy_minus_sign:                                             | N/A                                                            |                                                                |
@@ -5,10 +5,10 @@ Reasoning detail encrypted schema

 ## Fields

-| Field                                                                                                          | Type                                                                                                           | Required                                                                                                       | Description                                                                                                    |
-| -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `type`                                                                                                         | [components.ReasoningDetailEncryptedType](../components/reasoningdetailencryptedtype.md)                       | :heavy_check_mark:                                                                                             | N/A                                                                                                            |
-| `data`                                                                                                         | *str*                                                                                                          | :heavy_check_mark:                                                                                             | N/A                                                                                                            |
-| `id`                                                                                                           | *OptionalNullable[str]*                                                                                        | :heavy_minus_sign:                                                                                             | N/A                                                                                                            |
-| `format_`                                                                                                      | [OptionalNullable[components.ReasoningDetailEncryptedFormat]](../components/reasoningdetailencryptedformat.md) | :heavy_minus_sign:                                                                                             | N/A                                                                                                            |
-| `index`                                                                                                        | *Optional[float]*                                                                                              | :heavy_minus_sign:                                                                                             | N/A                                                                                                            |
+| Field                                                                                    | Type                                                                                     | Required                                                                                 | Description                                                                              | Example                                                                                  |
+| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `data`                                                                                   | *str*                                                                                    | :heavy_check_mark:                                                                       | N/A                                                                                      |                                                                                          |
+| `format_`                                                                                | [OptionalNullable[components.ReasoningFormat]](../components/reasoningformat.md)         | :heavy_minus_sign:                                                                       | N/A                                                                                      | unknown                                                                                  |
+| `id`                                                                                     | *OptionalNullable[str]*                                                                  | :heavy_minus_sign:                                                                       | N/A                                                                                      |                                                                                          |
+| `index`                                                                                  | *Optional[int]*                                                                          | :heavy_minus_sign:                                                                       | N/A                                                                                      |                                                                                          |
+| `type`                                                                                   | [components.ReasoningDetailEncryptedType](../components/reasoningdetailencryptedtype.md) | :heavy_check_mark:                                                                       | N/A                                                                                      |                                                                                          |
@@ -1,13 +0,0 @@
-# ReasoningDetailEncryptedFormat
-
-
-## Values
-
-| Name                        | Value                       |
-| --------------------------- | --------------------------- |
-| `UNKNOWN`                   | unknown                     |
-| `OPENAI_RESPONSES_V1`       | openai-responses-v1         |
-| `AZURE_OPENAI_RESPONSES_V1` | azure-openai-responses-v1   |
-| `XAI_RESPONSES_V1`          | xai-responses-v1            |
-| `ANTHROPIC_CLAUDE_V1`       | anthropic-claude-v1         |
-| `GOOGLE_GEMINI_V1`          | google-gemini-v1            |
@@ -5,10 +5,10 @@ Reasoning detail summary schema

 ## Fields

-| Field                                                                                                      | Type                                                                                                       | Required                                                                                                   | Description                                                                                                |
-| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `type`                                                                                                     | [components.ReasoningDetailSummaryType](../components/reasoningdetailsummarytype.md)                       | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
-| `summary`                                                                                                  | *str*                                                                                                      | :heavy_check_mark:                                                                                         | N/A                                                                                                        |
-| `id`                                                                                                       | *OptionalNullable[str]*                                                                                    | :heavy_minus_sign:                                                                                         | N/A                                                                                                        |
-| `format_`                                                                                                  | [OptionalNullable[components.ReasoningDetailSummaryFormat]](../components/reasoningdetailsummaryformat.md) | :heavy_minus_sign:                                                                                         | N/A                                                                                                        |
-| `index`                                                                                                    | *Optional[float]*                                                                                          | :heavy_minus_sign:                                                                                         | N/A                                                                                                        |
+| Field                                                                                | Type                                                                                 | Required                                                                             | Description                                                                          | Example                                                                              |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
+| `format_`                                                                            | [OptionalNullable[components.ReasoningFormat]](../components/reasoningformat.md)     | :heavy_minus_sign:                                                                   | N/A                                                                                  | unknown                                                                              |
+| `id`                                                                                 | *OptionalNullable[str]*                                                              | :heavy_minus_sign:                                                                   | N/A                                                                                  |                                                                                      |
+| `index`                                                                              | *Optional[int]*                                                                      | :heavy_minus_sign:                                                                   | N/A                                                                                  |                                                                                      |
+| `summary`                                                                            | *str*                                                                                | :heavy_check_mark:                                                                   | N/A                                                                                  |                                                                                      |
+| `type`                                                                               | [components.ReasoningDetailSummaryType](../components/reasoningdetailsummarytype.md) | :heavy_check_mark:                                                                   | N/A                                                                                  |                                                                                      |
@@ -1,13 +0,0 @@
-# ReasoningDetailSummaryFormat
-
-
-## Values
-
-| Name                        | Value                       |
-| --------------------------- | --------------------------- |
-| `UNKNOWN`                   | unknown                     |
-| `OPENAI_RESPONSES_V1`       | openai-responses-v1         |
-| `AZURE_OPENAI_RESPONSES_V1` | azure-openai-responses-v1   |
-| `XAI_RESPONSES_V1`          | xai-responses-v1            |
-| `ANTHROPIC_CLAUDE_V1`       | anthropic-claude-v1         |
-| `GOOGLE_GEMINI_V1`          | google-gemini-v1            |
@@ -5,11 +5,11 @@ Reasoning detail text schema

 ## Fields

-| Field                                                                                                | Type                                                                                                 | Required                                                                                             | Description                                                                                          |
-| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `type`                                                                                               | [components.ReasoningDetailTextType](../components/reasoningdetailtexttype.md)                       | :heavy_check_mark:                                                                                   | N/A                                                                                                  |
-| `text`                                                                                               | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `signature`                                                                                          | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `id`                                                                                                 | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `format_`                                                                                            | [OptionalNullable[components.ReasoningDetailTextFormat]](../components/reasoningdetailtextformat.md) | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
-| `index`                                                                                              | *Optional[float]*                                                                                    | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
+| Field                                                                            | Type                                                                             | Required                                                                         | Description                                                                      | Example                                                                          |
+| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `format_`                                                                        | [OptionalNullable[components.ReasoningFormat]](../components/reasoningformat.md) | :heavy_minus_sign:                                                               | N/A                                                                              | unknown                                                                          |
+| `id`                                                                             | *OptionalNullable[str]*                                                          | :heavy_minus_sign:                                                               | N/A                                                                              |                                                                                  |
+| `index`                                                                          | *Optional[int]*                                                                  | :heavy_minus_sign:                                                               | N/A                                                                              |                                                                                  |
+| `signature`                                                                      | *OptionalNullable[str]*                                                          | :heavy_minus_sign:                                                               | N/A                                                                              |                                                                                  |
+| `text`                                                                           | *OptionalNullable[str]*                                                          | :heavy_minus_sign:                                                               | N/A                                                                              |                                                                                  |
+| `type`                                                                           | [components.ReasoningDetailTextType](../components/reasoningdetailtexttype.md)   | :heavy_check_mark:                                                               | N/A                                                                              |                                                                                  |
@@ -1,13 +0,0 @@
-# ReasoningDetailTextFormat
-
-
-## Values
-
-| Name                        | Value                       |
-| --------------------------- | --------------------------- |
-| `UNKNOWN`                   | unknown                     |
-| `OPENAI_RESPONSES_V1`       | openai-responses-v1         |
-| `AZURE_OPENAI_RESPONSES_V1` | azure-openai-responses-v1   |
-| `XAI_RESPONSES_V1`          | xai-responses-v1            |
-| `ANTHROPIC_CLAUDE_V1`       | anthropic-claude-v1         |
-| `GOOGLE_GEMINI_V1`          | google-gemini-v1            |
@@ -5,18 +5,18 @@ Reasoning detail union schema

 ## Supported Types

-### `components.ReasoningDetailSummary`
-
-```python
-value: components.ReasoningDetailSummary = /* values here */
-```
-
 ### `components.ReasoningDetailEncrypted`

 ```python
 value: components.ReasoningDetailEncrypted = /* values here */
 ```

+### `components.ReasoningDetailSummary`
+
+```python
+value: components.ReasoningDetailSummary = /* values here */
+```
+
 ### `components.ReasoningDetailText`

 ```python
@@ -5,5 +5,5 @@

 | Field                                                                            | Type                                                                             | Required                                                                         | Description                                                                      |
 | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| `type`                                                                           | [components.ReasoningSummaryTextType](../components/reasoningsummarytexttype.md) | :heavy_check_mark:                                                               | N/A                                                                              |
-| `text`                                                                           | *str*                                                                            | :heavy_check_mark:                                                               | N/A                                                                              |
+| `text`                                                                           | *str*                                                                            | :heavy_check_mark:                                                               | N/A                                                                              |
+| `type`                                                                           | [components.ReasoningSummaryTextType](../components/reasoningsummarytexttype.md) | :heavy_check_mark:                                                               | N/A                                                                              |
@@ -5,5 +5,5 @@

 | Field                                                                            | Type                                                                             | Required                                                                         | Description                                                                      |
 | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| `type`                                                                           | [components.ReasoningTextContentType](../components/reasoningtextcontenttype.md) | :heavy_check_mark:                                                               | N/A                                                                              |
-| `text`                                                                           | *str*                                                                            | :heavy_check_mark:                                                               | N/A                                                                              |
+| `text`                                                                           | *str*                                                                            | :heavy_check_mark:                                                               | N/A                                                                              |
+| `type`                                                                           | [components.ReasoningTextContentType](../components/reasoningtextcontenttype.md) | :heavy_check_mark:                                                               | N/A                                                                              |
@@ -5,10 +5,10 @@ Response format configuration

 ## Supported Types

-### `components.ChatFormatTextConfig`
+### `components.ChatFormatGrammarConfig`

 ```python
-value: components.ChatFormatTextConfig = /* values here */
+value: components.ChatFormatGrammarConfig = /* values here */
 ```

 ### `components.FormatJSONObjectConfig`
@@ -23,15 +23,15 @@ value: components.FormatJSONObjectConfig = /* values here */
 value: components.ChatFormatJSONSchemaConfig = /* values here */
 ```

-### `components.ChatFormatGrammarConfig`
-
-```python
-value: components.ChatFormatGrammarConfig = /* values here */
-```
-
 ### `components.ChatFormatPythonConfig`

 ```python
 value: components.ChatFormatPythonConfig = /* values here */
 ```

+### `components.ChatFormatTextConfig`
+
+```python
+value: components.ChatFormatTextConfig = /* values here */
+```
+
@@ -5,7 +5,7 @@

 | Field                                                                                    | Type                                                                                     | Required                                                                                 | Description                                                                              |
 | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
-| `type`                                                                                   | [components.ResponseOutputTextType](../components/responseoutputtexttype.md)             | :heavy_check_mark:                                                                       | N/A                                                                                      |
-| `text`                                                                                   | *str*                                                                                    | :heavy_check_mark:                                                                       | N/A                                                                                      |
 | `annotations`                                                                            | List[[components.OpenAIResponsesAnnotation](../components/openairesponsesannotation.md)] | :heavy_minus_sign:                                                                       | N/A                                                                                      |
-| `logprobs`                                                                               | List[[components.ResponseOutputTextLogprob](../components/responseoutputtextlogprob.md)] | :heavy_minus_sign:                                                                       | N/A                                                                                      |
+| `logprobs`                                                                               | List[[components.Logprob](../components/logprob.md)]                                     | :heavy_minus_sign:                                                                       | N/A                                                                                      |
+| `text`                                                                                   | *str*                                                                                    | :heavy_check_mark:                                                                       | N/A                                                                                      |
+| `type`                                                                                   | [components.ResponseOutputTextType](../components/responseoutputtexttype.md)             | :heavy_check_mark:                                                                       | N/A                                                                                      |
@@ -5,6 +5,6 @@

 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `token`            | *str*              | :heavy_check_mark: | N/A                |
-| `bytes_`           | List[*float*]      | :heavy_check_mark: | N/A                |
-| `logprob`          | *float*            | :heavy_check_mark: | N/A                |
+| `bytes_`           | List[*int*]        | :heavy_check_mark: | N/A                |
+| `logprob`          | *float*            | :heavy_check_mark: | N/A                |
+| `token`            | *str*              | :heavy_check_mark: | N/A                |
@@ -13,6 +13,7 @@ Tokenizer type used by the model
 | `GPT`       | GPT         |
 | `CLAUDE`    | Claude      |
 | `GEMINI`    | Gemini      |
+| `GEMMA`     | Gemma       |
 | `GROK`      | Grok        |
 | `COHERE`    | Cohere      |
 | `NOVA`      | Nova        |
@@ -7,6 +7,6 @@ Information about the top provider for this model

 | Field                                           | Type                                            | Required                                        | Description                                     | Example                                         |
 | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- |
-| `context_length`                                | *OptionalNullable[float]*                       | :heavy_minus_sign:                              | Context length from the top provider            | 8192                                            |
-| `max_completion_tokens`                         | *OptionalNullable[float]*                       | :heavy_minus_sign:                              | Maximum completion tokens from the top provider | 4096                                            |
-| `is_moderated`                                  | *bool*                                          | :heavy_check_mark:                              | Whether the top provider moderates content      | true                                            |
+| `context_length`                                | *OptionalNullable[int]*                         | :heavy_minus_sign:                              | Context length from the top provider            | 8192                                            |
+| `is_moderated`                                  | *bool*                                          | :heavy_check_mark:                              | Whether the top provider moderates content      | true                                            |
+| `max_completion_tokens`                         | *OptionalNullable[int]*                         | :heavy_minus_sign:                              | Maximum completion tokens from the top provider | 4096                                            |
@@ -1,8 +0,0 @@
-# TypeResponseCompleted
-
-
-## Values
-
-| Name                 | Value                |
-| -------------------- | -------------------- |
-| `RESPONSE_COMPLETED` | response.completed   |
@@ -1,8 +0,0 @@
-# TypeResponseCreated
-
-
-## Values
-
-| Name               | Value              |
-| ------------------ | ------------------ |
-| `RESPONSE_CREATED` | response.created   |
@@ -1,8 +0,0 @@
-# TypeResponseFailed
-
-
-## Values
-
-| Name              | Value             |
-| ----------------- | ----------------- |
-| `RESPONSE_FAILED` | response.failed   |
@@ -1,8 +0,0 @@
-# TypeResponseIncomplete
-
-
-## Values
-
-| Name                  | Value                 |
-| --------------------- | --------------------- |
-| `RESPONSE_INCOMPLETE` | response.incomplete   |
@@ -1,8 +0,0 @@
-# TypeResponseInProgress
-
-
-## Values
-
-| Name                   | Value                  |
-| ---------------------- | ---------------------- |
-| `RESPONSE_IN_PROGRESS` | response.in_progress   |
@@ -1,8 +0,0 @@
-# TypeResponseOutputItemAdded
-
-
-## Values
-
-| Name                         | Value                        |
-| ---------------------------- | ---------------------------- |
-| `RESPONSE_OUTPUT_ITEM_ADDED` | response.output_item.added   |
@@ -1,8 +0,0 @@
-# TypeResponseOutputItemDone
-
-
-## Values
-
-| Name                        | Value                       |
-| --------------------------- | --------------------------- |
-| `RESPONSE_OUTPUT_ITEM_DONE` | response.output_item.done   |
@@ -5,8 +5,9 @@

 | Field                                                          | Type                                                           | Required                                                       | Description                                                    |
 | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
-| `type`                                                         | [components.URLCitationType](../components/urlcitationtype.md) | :heavy_check_mark:                                             | N/A                                                            |
-| `url`                                                          | *str*                                                          | :heavy_check_mark:                                             | N/A                                                            |
+| `content`                                                      | *Optional[str]*                                                | :heavy_minus_sign:                                             | N/A                                                            |
+| `end_index`                                                    | *int*                                                          | :heavy_check_mark:                                             | N/A                                                            |
+| `start_index`                                                  | *int*                                                          | :heavy_check_mark:                                             | N/A                                                            |
 | `title`                                                        | *str*                                                          | :heavy_check_mark:                                             | N/A                                                            |
-| `start_index`                                                  | *float*                                                        | :heavy_check_mark:                                             | N/A                                                            |
-| `end_index`                                                    | *float*                                                        | :heavy_check_mark:                                             | N/A                                                            |
+| `type`                                                         | [components.URLCitationType](../components/urlcitationtype.md) | :heavy_check_mark:                                             | N/A                                                            |
+| `url`                                                          | *str*                                                          | :heavy_check_mark:                                             | N/A                                                            |
@@ -5,9 +5,10 @@ The search engine to use for web search.

 ## Values

-| Name        | Value       |
-| ----------- | ----------- |
-| `NATIVE`    | native      |
-| `EXA`       | exa         |
-| `FIRECRAWL` | firecrawl   |
-| `PARALLEL`  | parallel    |
+| Name         | Value        |
+| ------------ | ------------ |
+| `NATIVE`     | native       |
+| `EXA`        | exa          |
+| `FIRECRAWL`  | firecrawl    |
+| `PARALLEL`   | parallel     |
+| `PERPLEXITY` | perplexity   |
@@ -8,4 +8,5 @@ Bad Gateway - Provider/upstream API failure
 | Field                                                                                  | Type                                                                                   | Required                                                                               | Description                                                                            | Example                                                                                |
 | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
 | `error`                                                                                | [components.BadGatewayResponseErrorData](../components/badgatewayresponseerrordata.md) | :heavy_check_mark:                                                                     | Error data for BadGatewayResponse                                                      | {<br/>"code": 502,<br/>"message": "Provider returned error"<br/>}                      |
+| `openrouter_metadata`                                                                  | Dict[str, *Nullable[Any]*]                                                             | :heavy_minus_sign:                                                                     | N/A                                                                                    |                                                                                        |
 | `user_id`                                                                              | *OptionalNullable[str]*                                                                | :heavy_minus_sign:                                                                     | N/A                                                                                    |                                                                                        |
@@ -8,4 +8,5 @@ Bad Request - Invalid request parameters or malformed input
 | Field                                                                                  | Type                                                                                   | Required                                                                               | Description                                                                            | Example                                                                                |
 | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
 | `error`                                                                                | [components.BadRequestResponseErrorData](../components/badrequestresponseerrordata.md) | :heavy_check_mark:                                                                     | Error data for BadRequestResponse                                                      | {<br/>"code": 400,<br/>"message": "Invalid request parameters"<br/>}                   |
+| `openrouter_metadata`                                                                  | Dict[str, *Nullable[Any]*]                                                             | :heavy_minus_sign:                                                                     | N/A                                                                                    |                                                                                        |
 | `user_id`                                                                              | *OptionalNullable[str]*                                                                | :heavy_minus_sign:                                                                     | N/A                                                                                    |                                                                                        |
@@ -8,4 +8,5 @@ Infrastructure Timeout - Provider request timed out at edge network
 | Field                                                                                                  | Type                                                                                                   | Required                                                                                               | Description                                                                                            | Example                                                                                                |
 | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
 | `error`                                                                                                | [components.EdgeNetworkTimeoutResponseErrorData](../components/edgenetworktimeoutresponseerrordata.md) | :heavy_check_mark:                                                                                     | Error data for EdgeNetworkTimeoutResponse                                                              | {<br/>"code": 524,<br/>"message": "Request timed out. Please try again later."<br/>}                   |
+| `openrouter_metadata`                                                                                  | Dict[str, *Nullable[Any]*]                                                                             | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
 | `user_id`                                                                                              | *OptionalNullable[str]*                                                                                | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
@@ -8,4 +8,5 @@ Forbidden - Authentication successful but insufficient permissions
 | Field                                                                                | Type                                                                                 | Required                                                                             | Description                                                                          | Example                                                                              |
 | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
 | `error`                                                                              | [components.ForbiddenResponseErrorData](../components/forbiddenresponseerrordata.md) | :heavy_check_mark:                                                                   | Error data for ForbiddenResponse                                                     | {<br/>"code": 403,<br/>"message": "Only management keys can perform this operation"<br/>} |
+| `openrouter_metadata`                                                                | Dict[str, *Nullable[Any]*]                                                           | :heavy_minus_sign:                                                                   | N/A                                                                                  |                                                                                      |
 | `user_id`                                                                            | *OptionalNullable[str]*                                                              | :heavy_minus_sign:                                                                   | N/A                                                                                  |                                                                                      |
@@ -8,4 +8,5 @@ Internal Server Error - Unexpected server error
 | Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    | Example                                                                                        |
 | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
 | `error`                                                                                        | [components.InternalServerResponseErrorData](../components/internalserverresponseerrordata.md) | :heavy_check_mark:                                                                             | Error data for InternalServerResponse                                                          | {<br/>"code": 500,<br/>"message": "Internal Server Error"<br/>}                                |
+| `openrouter_metadata`                                                                          | Dict[str, *Nullable[Any]*]                                                                     | :heavy_minus_sign:                                                                             | N/A                                                                                            |                                                                                                |
 | `user_id`                                                                                      | *OptionalNullable[str]*                                                                        | :heavy_minus_sign:                                                                             | N/A                                                                                            |                                                                                                |
@@ -8,4 +8,5 @@ Not Found - Resource does not exist
 | Field                                                                              | Type                                                                               | Required                                                                           | Description                                                                        | Example                                                                            |
 | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
 | `error`                                                                            | [components.NotFoundResponseErrorData](../components/notfoundresponseerrordata.md) | :heavy_check_mark:                                                                 | Error data for NotFoundResponse                                                    | {<br/>"code": 404,<br/>"message": "Resource not found"<br/>}                       |
+| `openrouter_metadata`                                                              | Dict[str, *Nullable[Any]*]                                                         | :heavy_minus_sign:                                                                 | N/A                                                                                |                                                                                    |
 | `user_id`                                                                          | *OptionalNullable[str]*                                                            | :heavy_minus_sign:                                                                 | N/A                                                                                |                                                                                    |
@@ -8,4 +8,5 @@ Payload Too Large - Request payload exceeds size limits
 | Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      | Example                                                                                          |
 | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
 | `error`                                                                                          | [components.PayloadTooLargeResponseErrorData](../components/payloadtoolargeresponseerrordata.md) | :heavy_check_mark:                                                                               | Error data for PayloadTooLargeResponse                                                           | {<br/>"code": 413,<br/>"message": "Request payload too large"<br/>}                              |
+| `openrouter_metadata`                                                                            | Dict[str, *Nullable[Any]*]                                                                       | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
 | `user_id`                                                                                        | *OptionalNullable[str]*                                                                          | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
@@ -8,4 +8,5 @@ Payment Required - Insufficient credits or quota to complete request
 | Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      | Example                                                                                          |
 | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
 | `error`                                                                                          | [components.PaymentRequiredResponseErrorData](../components/paymentrequiredresponseerrordata.md) | :heavy_check_mark:                                                                               | Error data for PaymentRequiredResponse                                                           | {<br/>"code": 402,<br/>"message": "Insufficient credits. Add more using https://openrouter.ai/credits"<br/>} |
+| `openrouter_metadata`                                                                            | Dict[str, *Nullable[Any]*]                                                                       | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
 | `user_id`                                                                                        | *OptionalNullable[str]*                                                                          | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
@@ -8,4 +8,5 @@ Provider Overloaded - Provider is temporarily overloaded
 | Field                                                                                                  | Type                                                                                                   | Required                                                                                               | Description                                                                                            | Example                                                                                                |
 | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
 | `error`                                                                                                | [components.ProviderOverloadedResponseErrorData](../components/provideroverloadedresponseerrordata.md) | :heavy_check_mark:                                                                                     | Error data for ProviderOverloadedResponse                                                              | {<br/>"code": 529,<br/>"message": "Provider returned error"<br/>}                                      |
+| `openrouter_metadata`                                                                                  | Dict[str, *Nullable[Any]*]                                                                             | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
 | `user_id`                                                                                              | *OptionalNullable[str]*                                                                                | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
@@ -8,4 +8,5 @@ Request Timeout - Operation exceeded time limit
 | Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    | Example                                                                                        |
 | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
 | `error`                                                                                        | [components.RequestTimeoutResponseErrorData](../components/requesttimeoutresponseerrordata.md) | :heavy_check_mark:                                                                             | Error data for RequestTimeoutResponse                                                          | {<br/>"code": 408,<br/>"message": "Operation timed out. Please try again later."<br/>}         |
+| `openrouter_metadata`                                                                          | Dict[str, *Nullable[Any]*]                                                                     | :heavy_minus_sign:                                                                             | N/A                                                                                            |                                                                                                |
 | `user_id`                                                                                      | *OptionalNullable[str]*                                                                        | :heavy_minus_sign:                                                                             | N/A                                                                                            |                                                                                                |
@@ -8,4 +8,5 @@ Service Unavailable - Service temporarily unavailable
 | Field                                                                                                  | Type                                                                                                   | Required                                                                                               | Description                                                                                            | Example                                                                                                |
 | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
 | `error`                                                                                                | [components.ServiceUnavailableResponseErrorData](../components/serviceunavailableresponseerrordata.md) | :heavy_check_mark:                                                                                     | Error data for ServiceUnavailableResponse                                                              | {<br/>"code": 503,<br/>"message": "Service temporarily unavailable"<br/>}                              |
+| `openrouter_metadata`                                                                                  | Dict[str, *Nullable[Any]*]                                                                             | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
 | `user_id`                                                                                              | *OptionalNullable[str]*                                                                                | :heavy_minus_sign:                                                                                     | N/A                                                                                                    |                                                                                                        |
@@ -8,4 +8,5 @@ Too Many Requests - Rate limit exceeded
 | Field                                                                                            | Type                                                                                             | Required                                                                                         | Description                                                                                      | Example                                                                                          |
 | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
 | `error`                                                                                          | [components.TooManyRequestsResponseErrorData](../components/toomanyrequestsresponseerrordata.md) | :heavy_check_mark:                                                                               | Error data for TooManyRequestsResponse                                                           | {<br/>"code": 429,<br/>"message": "Rate limit exceeded"<br/>}                                    |
+| `openrouter_metadata`                                                                            | Dict[str, *Nullable[Any]*]                                                                       | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
 | `user_id`                                                                                        | *OptionalNullable[str]*                                                                          | :heavy_minus_sign:                                                                               | N/A                                                                                              |                                                                                                  |
@@ -8,4 +8,5 @@ Unauthorized - Authentication required or invalid credentials
 | Field                                                                                      | Type                                                                                       | Required                                                                                   | Description                                                                                | Example                                                                                    |
 | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
 | `error`                                                                                    | [components.UnauthorizedResponseErrorData](../components/unauthorizedresponseerrordata.md) | :heavy_check_mark:                                                                         | Error data for UnauthorizedResponse                                                        | {<br/>"code": 401,<br/>"message": "Missing Authentication header"<br/>}                    |
+| `openrouter_metadata`                                                                      | Dict[str, *Nullable[Any]*]                                                                 | :heavy_minus_sign:                                                                         | N/A                                                                                        |                                                                                            |
 | `user_id`                                                                                  | *OptionalNullable[str]*                                                                    | :heavy_minus_sign:                                                                         | N/A                                                                                        |                                                                                            |
@@ -8,4 +8,5 @@ Unprocessable Entity - Semantic validation failure
 | Field                                                                                                    | Type                                                                                                     | Required                                                                                                 | Description                                                                                              | Example                                                                                                  |
 | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
 | `error`                                                                                                  | [components.UnprocessableEntityResponseErrorData](../components/unprocessableentityresponseerrordata.md) | :heavy_check_mark:                                                                                       | Error data for UnprocessableEntityResponse                                                               | {<br/>"code": 422,<br/>"message": "Invalid argument"<br/>}                                               |
+| `openrouter_metadata`                                                                                    | Dict[str, *Nullable[Any]*]                                                                               | :heavy_minus_sign:                                                                                       | N/A                                                                                                      |                                                                                                          |
 | `user_id`                                                                                                | *OptionalNullable[str]*                                                                                  | :heavy_minus_sign:                                                                                       | N/A                                                                                                      |                                                                                                          |
--- a/Show More
+++ b/Show More