diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock
index ffda4276..60654d0b 100644
--- a/.speakeasy/gen.lock
+++ b/.speakeasy/gen.lock
@@ -1,19 +1,19 @@
lockVersion: 2.0.0
id: c48cf606-fb42-4a45-9c23-8f0555307828
management:
- docChecksum: 2bbc83374f2d66f64b1d96b5d61876df
+ docChecksum: 7e01e4863466a4b473e43c47c419b196
docVersion: 1.0.0
speakeasyVersion: 1.803.2
generationVersion: 2.950.13
- releaseVersion: 1.3.181
- configChecksum: 80a933d10a8dba8067fcef3845483e09
+ releaseVersion: 1.3.182
+ configChecksum: 93e89301ad9a52d796393b76a744e7ef
repoURL: https://github.com/OpenRouterTeam/python-sdk.git
installationURL: https://github.com/OpenRouterTeam/python-sdk.git
published: true
persistentEdits:
- generation_id: c7a792f5-261f-4da3-a5b1-f7c99b780d8a
- pristine_commit_hash: 2eec7461373428cc4d40dfd2b59e5e9d1398cded
- pristine_tree_hash: 1af1a4dd6d09e89882a19bb8d33becb3625c728a
+ generation_id: 21b1feaa-ecfe-47bf-bd5f-590eb8bc26a5
+ pristine_commit_hash: a61541c522dd7c6128eaef1b9466727b5e78d412
+ pristine_tree_hash: 723ddcad6a09d1e49ebe35bd7fd99d059a35786c
features:
python:
acceptHeaders: 3.0.0
@@ -1376,12 +1376,12 @@ trackedFiles:
pristine_git_object: 800b8e4a3fd07f10592e3ee8f9c15c7e57398d4c
docs/components/autorouterplugin.mdx:
id: 4d62f9b36bc2
- last_write_checksum: sha1:d7e7c34897727c489f0425db242d706a2f088747
- pristine_git_object: 3aae91bab56242f455574740264ca3a410ffdcb3
+ last_write_checksum: sha1:218994f2a1dbff27ea71be8f5a1e4538811d8ccd
+ pristine_git_object: 6e3cffd6ed96a00eae118aba9c1cd503377a7514
docs/components/autorouterplugincosttier.mdx:
id: 72049c1ccaf4
- last_write_checksum: sha1:e39aa2557889658bd06007f9731c277e9b537e12
- pristine_git_object: b06654b8292488471ec316b3f2aceec6eacf5db8
+ last_write_checksum: sha1:d376bd86d2a3c43e7ad9191ca83b97f92507d5fb
+ pristine_git_object: 6c57994fc76a90580714e614475fe47ffbc2027e
docs/components/autorouterpluginid.mdx:
id: ea9862a88ce8
last_write_checksum: sha1:51d6cd6296501209ebc8b721adb3feadeb798f9a
@@ -4812,8 +4812,8 @@ trackedFiles:
pristine_git_object: 5949fbaa48fde55f28b1597cd0ac15ae13c5852a
docs/components/jevrouterplugin.mdx:
id: 258aa7058bc5
- last_write_checksum: sha1:f1ba78a999fd265a4ae83caa21fcca1997292eb7
- pristine_git_object: c7d2583cf205a5abc962118f9cab3762fcfa4002
+ last_write_checksum: sha1:77aabf88838874c0ecf00076ae26c1d4cc0fcba4
+ pristine_git_object: fd57392a0ce10e1996c0e9bf28badf52bb0ba94f
docs/components/jevrouterpluginid.mdx:
id: 30d920f53cde
last_write_checksum: sha1:dfc1a3a7d9011c2a15b475b51eaf48ad78856ff3
@@ -11680,8 +11680,8 @@ trackedFiles:
pristine_git_object: 3e38f1a929f7d6b1d6de74604aa87e3d8f010544
pyproject.toml:
id: 5d07e7d72637
- last_write_checksum: sha1:7427ffc8ffe039541ef5a0bf0cb15bf315e072dc
- pristine_git_object: 6ce71bfafad02f38221db45b606085923b010389
+ last_write_checksum: sha1:7345c283fb35d1d19266b68967f0bb03fcbef9b1
+ pristine_git_object: 2328adbfdbd5909ff58a402f0a49f29c9b59a692
scripts/prepare_readme.py:
id: e0c5957a6035
last_write_checksum: sha1:77f44b60b98bc126557ec27391f91dfba764bb54
@@ -11708,8 +11708,8 @@ trackedFiles:
pristine_git_object: 86713cfea633e09d33b3d4e65281071fe20e6137
src/openrouter/_version.py:
id: d8d15ad6c586
- last_write_checksum: sha1:2918aa21adc139d698e22f34f573bb9fcad7e56d
- pristine_git_object: 4b8ffa897c22aeb12e97c3c3073e3a63bb9462f9
+ last_write_checksum: sha1:39ba4a2a21183633640d3d5cf0297ca9d0e10b39
+ pristine_git_object: b635535503d4ef9ae530217819baafaa5cbcc733
src/openrouter/alpha.py:
id: 306c4d93308d
last_write_checksum: sha1:80cc0f39649445431cc2247ed0e0765438467766
@@ -12364,8 +12364,8 @@ trackedFiles:
pristine_git_object: 9cd3b5786a3b408de1ea89f7ea25592153c78fc7
src/openrouter/components/autorouterplugin.py:
id: cf49add5d1ae
- last_write_checksum: sha1:b6c8d8841b8590431f3260715fa7f91d84d29246
- pristine_git_object: 487b74a0930560d1d0acd0415ff0765d00b9c5af
+ last_write_checksum: sha1:478341beda4b2a2e2a96b4dd4d9c5e256d1dc6c2
+ pristine_git_object: 99065ce5e2350b97b178e5b4066d0a32254a36c7
src/openrouter/components/badgatewayresponseerrordata.py:
id: f7a33d30d269
last_write_checksum: sha1:d85ab25a06594703cb353767f07f4e1d44e0181c
@@ -13732,8 +13732,8 @@ trackedFiles:
pristine_git_object: b5a0bc16faa52f26d293eea18183e4d0b0bbb901
src/openrouter/components/jevrouterplugin.py:
id: fcb6e65e2e08
- last_write_checksum: sha1:d3f27bd7686c3f38a13dba021a0ff578ba95e00e
- pristine_git_object: cd0a9e0cf7b7a334a987dcb31d4b6601906c3b89
+ last_write_checksum: sha1:95cddb747ae16339fcd4ff907c062b8667999f1e
+ pristine_git_object: deed2db578c63adb44bc894aba195f402b96458a
src/openrouter/components/keyassignment.py:
id: 07a64362e7fd
last_write_checksum: sha1:4b47a6f1ab4992ec81d7236ca28dbf94d3a4fbaf
@@ -21719,7 +21719,3 @@ examples:
"500":
application/json: {"error": {"code": 500, "message": "Internal Server Error"}}
examplesVersion: 1.0.2
-releaseNotes: |
- ## Python SDK Changes:
- * `open_router.video_generation.generate()`: `request.aspect_ratio` **Changed**
- * `open_router.video_generation.list_videos_models()`: `response.data[]` **Changed**
diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml
index bfadb0f2..674717a9 100644
--- a/.speakeasy/gen.yaml
+++ b/.speakeasy/gen.yaml
@@ -37,7 +37,7 @@ generation:
documentation: mintlify
preApplyUnionDiscriminators: true
python:
- version: 1.3.181
+ version: 1.3.182
additionalDependencies:
dev:
pytest: '>=8.3'
diff --git a/.speakeasy/out.openapi.yaml b/.speakeasy/out.openapi.yaml
index 1b680eb7..defac8b8 100644
--- a/.speakeasy/out.openapi.yaml
+++ b/.speakeasy/out.openapi.yaml
@@ -4027,7 +4027,7 @@ components:
minimum: 0
type: 'integer'
cost_tier:
- description: 'Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided.'
+ description: 'Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy.'
enum:
- 'low'
- 'medium'
@@ -18304,7 +18304,7 @@ components:
maxItems: 1024
type: 'array'
cost_tier:
- description: 'Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. Model exclusions and the router kill switch still apply.'
+ description: 'Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. On openrouter/auto-code, low and high (or auto-code-low and auto-code-high) pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and every other value, or a version that is not available, runs on the default Auto Code policy. Model exclusions and the router kill switch still apply.'
example: 'medium'
pattern: '^[a-z][a-z0-9_-]{0,31}$'
type: 'string'
diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock
index 766c7e3a..32a88e79 100644
--- a/.speakeasy/workflow.lock
+++ b/.speakeasy/workflow.lock
@@ -2,8 +2,8 @@ speakeasyVersion: 1.803.2
sources:
OpenRouter API:
sourceNamespace: open-router-chat-completions-api
- sourceRevisionDigest: sha256:cbe0a9ae33d874147e00ab18c10196c6ca7d882f31c81e8293def439d55f3463
- sourceBlobDigest: sha256:f834219afd1e212f20e4dcfe3cbb4fdef5a8369f7fe54d99e5fdad4b813778d3
+ sourceRevisionDigest: sha256:1cca2238e45f069aea6f9cc204b19b8551f052359b12fa03f317f9e18c04c150
+ sourceBlobDigest: sha256:92479e3528c7f73a561d729ec9f536f6eea6c00676913e7d7312b699c3b39d8f
tags:
- latest
- 1.0.0
@@ -11,10 +11,10 @@ targets:
open-router:
source: OpenRouter API
sourceNamespace: open-router-chat-completions-api
- sourceRevisionDigest: sha256:cbe0a9ae33d874147e00ab18c10196c6ca7d882f31c81e8293def439d55f3463
- sourceBlobDigest: sha256:f834219afd1e212f20e4dcfe3cbb4fdef5a8369f7fe54d99e5fdad4b813778d3
+ sourceRevisionDigest: sha256:1cca2238e45f069aea6f9cc204b19b8551f052359b12fa03f317f9e18c04c150
+ sourceBlobDigest: sha256:92479e3528c7f73a561d729ec9f536f6eea6c00676913e7d7312b699c3b39d8f
codeSamplesNamespace: open-router-python-code-samples
- codeSamplesRevisionDigest: sha256:1ec08135c25b73c0bf50778ec1037d48ed81d855c6679564151e11d0f19d1a7e
+ codeSamplesRevisionDigest: sha256:128a1a830c7a93b6980d3cbe90babc42c91539cc9ec7e984b2ff26577dc3660f
workflow:
workflowVersion: 1.0.0
speakeasyVersion: 1.803.2
diff --git a/RELEASES.md b/RELEASES.md
index 2becc55f..e76bec54 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -4579,4 +4579,14 @@ Based on:
### Generated
- [python v1.3.181] .
### Releases
-- [PyPI v1.3.181] https://pypi.org/project/openrouter/1.3.181 - .
\ No newline at end of file
+- [PyPI v1.3.181] https://pypi.org/project/openrouter/1.3.181 - .
+
+## 2026-11-16 17:22:57
+### Changes
+Based on:
+- OpenAPI Doc
+- Speakeasy CLI 1.803.2 (2.950.13) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v1.3.182] .
+### Releases
+- [PyPI v1.3.182] https://pypi.org/project/openrouter/1.3.182 - .
\ No newline at end of file
diff --git a/docs/components/autorouterplugin.mdx b/docs/components/autorouterplugin.mdx
index 3aae91ba..6e3cffd6 100644
--- a/docs/components/autorouterplugin.mdx
+++ b/docs/components/autorouterplugin.mdx
@@ -8,7 +8,7 @@ title: "AutoRouterPlugin"
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `allowed_models` | List[*str*] | ➖ | List of model patterns to filter which models the auto-router can route between. Supports wildcards (e.g., "anthropic/*" matches all Anthropic models). Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. When not specified, every model ranked for the classified task type is a candidate, falling back to a default model set when rankings are unavailable. | [
"anthropic/*",
"openai/gpt-4o",
"google/*"
] |
| ~~`cost_quality_tradeoff`~~ | *Optional[int]* | ➖ | ⚠️ **DEPRECATED**: This will be removed in a future release, please migrate away from it as soon as possible.
Deprecated: Use cost_tier instead. Balances routing between cost and quality on a 0-10 scale. The auto-router ranks models for the classified task type by community spend share, then filters candidates by their average cost per generation for that task. Higher values favor cheaper models: 10 keeps only models around the cheapest 10th percentile, while 0 permits models up to the 90th percentile for cost. Defaults to 9 when no cost setting is provided. It remains supported and retains ceiling behavior, but cost_tier takes precedence when both are provided. | 9 |
-| `cost_tier` | [Optional[components.AutoRouterPluginCostTier]](../components/autorouterplugincosttier.mdx) | ➖ | Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. | low |
+| `cost_tier` | [Optional[components.AutoRouterPluginCostTier]](../components/autorouterplugincosttier.mdx) | ➖ | Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy. | low |
| `enabled` | *Optional[bool]* | ➖ | Set to false to disable the auto-router plugin for this request. Defaults to true. | |
| `excluded_models` | List[*str*] | ➖ | List of model patterns to exclude from auto-router selection. Supports wildcards (e.g., "meta-llama/*" excludes all Llama models). Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. Applied after allowed_models, so an excluded pattern always wins over an allowed one. | [
"openai/gpt-4o",
"meta-llama/*"
] |
| `id` | [components.AutoRouterPluginID](../components/autorouterpluginid.mdx) | ✔️ | N/A | |
diff --git a/docs/components/autorouterplugincosttier.mdx b/docs/components/autorouterplugincosttier.mdx
index b06654b8..6c57994f 100644
--- a/docs/components/autorouterplugincosttier.mdx
+++ b/docs/components/autorouterplugincosttier.mdx
@@ -2,7 +2,7 @@
title: "AutoRouterPluginCostTier"
---
-Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided.
+Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy.
## Example Usage
diff --git a/docs/components/jevrouterplugin.mdx b/docs/components/jevrouterplugin.mdx
index c7d2583c..fd57392a 100644
--- a/docs/components/jevrouterplugin.mdx
+++ b/docs/components/jevrouterplugin.mdx
@@ -7,7 +7,7 @@ title: "JevRouterPlugin"
| Field | Type | Required | Description | Example |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowed_models` | List[*str*] | ➖ | Alias of `models`, matching the auto-router field name. Entries from both fields are combined. | [
"anthropic/*"
] |
-| `cost_tier` | *Optional[str]* | ➖ | Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. Model exclusions and the router kill switch still apply. | medium |
+| `cost_tier` | *Optional[str]* | ➖ | Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. On openrouter/auto-code, low and high (or auto-code-low and auto-code-high) pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and every other value, or a version that is not available, runs on the default Auto Code policy. Model exclusions and the router kill switch still apply. | medium |
| `excluded_models` | List[*str*] | ➖ | Remove these models from the router. Each entry is a model slug or a wildcard pattern (e.g. "xiaomi/*"). A `~author/family-latest` alias matches every revision of that family. Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. Applied after `models`, so an excluded pattern always wins over an included one; when the lists leave no model the request can use, it fails with 404 rather than routing outside them. | [
"openai/gpt-6-astra",
"xiaomi/*"
] |
| `id` | [components.JevRouterPluginID](../components/jevrouterpluginid.mdx) | ✔️ | N/A | |
| `models` | List[*str*] | ➖ | Restrict the router to these models. Each entry is a model slug or a wildcard pattern (e.g. "anthropic/*"), matched against the current pool; models outside the pool are ignored. A `~author/family-latest` alias matches every revision of that family. Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. When omitted or empty, every model in the pool is a candidate; when no pool model matches, the list is ignored and the whole pool is used (`excluded_models` still apply). When no entry matches any catalog model, for example a misspelled slug, the request fails with 404 instead. `allowed_models` is an alias; entries from both fields are combined. | [
"anthropic/*",
"openai/gpt-5.6-sol"
] |
\ No newline at end of file
diff --git a/pyproject.toml b/pyproject.toml
index 6ce71bfa..2328adbf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "openrouter"
-version = "1.3.181"
+version = "1.3.182"
description = "Official Python Client SDK for OpenRouter."
authors = [{ name = "OpenRouter" },]
readme = "README-PYPI.md"
diff --git a/src/openrouter/_version.py b/src/openrouter/_version.py
index 4b8ffa89..b6355355 100644
--- a/src/openrouter/_version.py
+++ b/src/openrouter/_version.py
@@ -3,10 +3,10 @@
import importlib.metadata
__title__: str = "openrouter"
-__version__: str = "1.3.181"
+__version__: str = "1.3.182"
__openapi_doc_version__: str = "1.0.0"
__gen_version__: str = "2.950.13"
-__user_agent__: str = "speakeasy-sdk/python 1.3.181 2.950.13 1.0.0 openrouter"
+__user_agent__: str = "speakeasy-sdk/python 1.3.182 2.950.13 1.0.0 openrouter"
try:
if __package__ is not None:
diff --git a/src/openrouter/components/autorouterplugin.py b/src/openrouter/components/autorouterplugin.py
index 487b74a0..99065ce5 100644
--- a/src/openrouter/components/autorouterplugin.py
+++ b/src/openrouter/components/autorouterplugin.py
@@ -18,7 +18,7 @@
],
UnrecognizedStr,
]
-r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided."""
+r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy."""
AutoRouterPluginID = Literal["auto-router",]
@@ -31,7 +31,7 @@ class AutoRouterPluginTypedDict(TypedDict):
cost_quality_tradeoff: NotRequired[int]
r"""Deprecated: Use cost_tier instead. Balances routing between cost and quality on a 0-10 scale. The auto-router ranks models for the classified task type by community spend share, then filters candidates by their average cost per generation for that task. Higher values favor cheaper models: 10 keeps only models around the cheapest 10th percentile, while 0 permits models up to the 90th percentile for cost. Defaults to 9 when no cost setting is provided. It remains supported and retains ceiling behavior, but cost_tier takes precedence when both are provided."""
cost_tier: NotRequired[AutoRouterPluginCostTier]
- r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided."""
+ r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy."""
enabled: NotRequired[bool]
r"""Set to false to disable the auto-router plugin for this request. Defaults to true."""
excluded_models: NotRequired[List[str]]
@@ -55,7 +55,7 @@ class AutoRouterPlugin(BaseModel):
r"""Deprecated: Use cost_tier instead. Balances routing between cost and quality on a 0-10 scale. The auto-router ranks models for the classified task type by community spend share, then filters candidates by their average cost per generation for that task. Higher values favor cheaper models: 10 keeps only models around the cheapest 10th percentile, while 0 permits models up to the 90th percentile for cost. Defaults to 9 when no cost setting is provided. It remains supported and retains ceiling behavior, but cost_tier takes precedence when both are provided."""
cost_tier: Optional[AutoRouterPluginCostTier] = None
- r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided."""
+ r"""Named cost/quality setting. Tiers select cost-percentile bands: low = [0, 20), medium = [20, 40), high = [40, 60), xhigh = [60, 80), and max = [80, 100]. Takes precedence over the deprecated numeric cost_quality_tradeoff when both are provided. On openrouter/auto-code, low and high pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and medium, or a version that is not available, runs on the default Auto Code policy."""
enabled: Optional[bool] = None
r"""Set to false to disable the auto-router plugin for this request. Defaults to true."""
diff --git a/src/openrouter/components/jevrouterplugin.py b/src/openrouter/components/jevrouterplugin.py
index cd0a9e0c..deed2db5 100644
--- a/src/openrouter/components/jevrouterplugin.py
+++ b/src/openrouter/components/jevrouterplugin.py
@@ -15,7 +15,7 @@ class JevRouterPluginTypedDict(TypedDict):
allowed_models: NotRequired[List[str]]
r"""Alias of `models`, matching the auto-router field name. Entries from both fields are combined."""
cost_tier: NotRequired[str]
- r"""Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. Model exclusions and the router kill switch still apply."""
+ r"""Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. On openrouter/auto-code, low and high (or auto-code-low and auto-code-high) pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and every other value, or a version that is not available, runs on the default Auto Code policy. Model exclusions and the router kill switch still apply."""
excluded_models: NotRequired[List[str]]
r"""Remove these models from the router. Each entry is a model slug or a wildcard pattern (e.g. \"xiaomi/*\"). A `~author/family-latest` alias matches every revision of that family. Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. Applied after `models`, so an excluded pattern always wins over an included one; when the lists leave no model the request can use, it fails with 404 rather than routing outside them."""
models: NotRequired[List[str]]
@@ -29,7 +29,7 @@ class JevRouterPlugin(BaseModel):
r"""Alias of `models`, matching the auto-router field name. Entries from both fields are combined."""
cost_tier: Optional[str] = None
- r"""Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. Model exclusions and the router kill switch still apply."""
+ r"""Select low, medium, high, or a cost tier configured by the operator. Overrides the live-config tier and replaces the shared routing policy with that tier. Omit to use the live configuration. On openrouter/auto-code, low and high (or auto-code-low and auto-code-high) pick a cheaper or stronger version of the Auto Code policy (xhigh and max count as high), and every other value, or a version that is not available, runs on the default Auto Code policy. Model exclusions and the router kill switch still apply."""
excluded_models: Optional[List[str]] = None
r"""Remove these models from the router. Each entry is a model slug or a wildcard pattern (e.g. \"xiaomi/*\"). A `~author/family-latest` alias matches every revision of that family. Up to 1024 patterns, each at most 1024 characters, with 65536 total characters across all patterns. Applied after `models`, so an excluded pattern always wins over an included one; when the lists leave no model the request can use, it fails with 404 rather than routing outside them."""
diff --git a/uv.lock b/uv.lock
index 478e362d..38ae93ef 100644
--- a/uv.lock
+++ b/uv.lock
@@ -231,7 +231,7 @@ wheels = [
[[package]]
name = "openrouter"
-version = "1.3.181"
+version = "1.3.182"
source = { editable = "." }
dependencies = [
{ name = "httpcore" },