Merge main into dev: resolve conflicts by keeping dev (latest Copybara exports)

GitOrigin-RevId: 55335c8a1cc66e6e032e9075d6f6eea5d9fb9138

.claude/settings.local.json

@@ -1,7 +1,9 @@
 {
   "permissions": {
     "allow": [
-      "Bash(python3:*)"
+      "Bash(python3:*)",
+      "Bash(git push:*)",
+      "Bash(gh pr create:*)"
     ],
     "deny": [],
     "ask": []

.speakeasy/gen.lock

@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: cfd52247-6a25-4c6d-bbce-fe6fce0cd69d
 management:
-  docChecksum: 4cc4a9d9115d0eca9a5eb4786505579d
+  docChecksum: 7419f3b58a64f08efb375ead9e169446
   docVersion: 1.0.0
-  speakeasyVersion: 1.658.2
+  speakeasyVersion: 1.666.0
-  generationVersion: 2.755.9
+  generationVersion: 2.768.0
-  releaseVersion: 0.0.19
+  releaseVersion: 0.0.17
-  configChecksum: 834d5c1cea368e35ab6535ffb2bf9e7a
+  configChecksum: 50ef18bf69272fc09c257e3562e1b0df
   repoURL: https://github.com/OpenRouterTeam/python-sdk.git
   installationURL: https://github.com/OpenRouterTeam/python-sdk.git
   published: true
@@ -15,7 +15,7 @@ features:
     acceptHeaders: 3.0.0
     additionalDependencies: 1.0.0
     constsAndDefaults: 1.0.5
-    core: 5.23.9
+    core: 5.23.13
     defaultEnabledRetries: 0.2.0
     deprecations: 3.0.2
     devContainers: 3.0.0
@@ -27,15 +27,17 @@ features:
     globalSecurityCallbacks: 1.0.0
     globalSecurityFlattening: 1.0.0
     globalServerURLs: 3.2.0
+    globals: 3.0.0
     groups: 3.0.1
+    ignores: 3.0.1
     methodArguments: 1.0.2
     methodSecurity: 3.0.1
     nameOverrides: 3.0.1
     nullables: 1.0.1
     openEnums: 1.0.1
     responseFormat: 1.0.1
-    retries: 3.0.2
+    retries: 3.0.3
-    sdkHooks: 1.1.0
+    sdkHooks: 1.2.0
     serverEvents: 1.0.11
     serverEventsSentinels: 0.1.0
     serverIDs: 3.0.0
@@ -57,6 +59,20 @@ generatedFiles:
   - docs/components/chatcompletionfinishreason.md
   - docs/components/chaterrorerror.md
   - docs/components/chatgenerationparams.md
+  - docs/components/chatgenerationparamsdatacollection.md
+  - docs/components/chatgenerationparamsimageconfig.md
+  - docs/components/chatgenerationparamsmaxprice.md
+  - docs/components/chatgenerationparamspluginautorouter.md
+  - docs/components/chatgenerationparamspluginfileparser.md
+  - docs/components/chatgenerationparamspluginmoderation.md
+  - docs/components/chatgenerationparamspluginresponsehealing.md
+  - docs/components/chatgenerationparamspluginunion.md
+  - docs/components/chatgenerationparamspluginweb.md
+  - docs/components/chatgenerationparamspreferredmaxlatency.md
+  - docs/components/chatgenerationparamspreferredmaxlatencyunion.md
+  - docs/components/chatgenerationparamspreferredminthroughput.md
+  - docs/components/chatgenerationparamspreferredminthroughputunion.md
+  - docs/components/chatgenerationparamsprovider.md
   - docs/components/chatgenerationparamsresponseformatjsonobject.md
   - docs/components/chatgenerationparamsresponseformatpython.md
   - docs/components/chatgenerationparamsresponseformattext.md
@@ -65,8 +81,8 @@ generatedFiles:
   - docs/components/chatgenerationtokenusage.md
   - docs/components/chatmessagecontentitem.md
   - docs/components/chatmessagecontentitemaudio.md
-  - docs/components/chatmessagecontentitemaudioformat.md
   - docs/components/chatmessagecontentitemaudioinputaudio.md
+  - docs/components/chatmessagecontentitemcachecontrol.md
   - docs/components/chatmessagecontentitemimage.md
   - docs/components/chatmessagecontentitemimagedetail.md
   - docs/components/chatmessagecontentitemtext.md
@@ -105,6 +121,7 @@ generatedFiles:
   - docs/components/costdetails.md
   - docs/components/createchargerequest.md
   - docs/components/datacollection.md
+  - docs/components/debug.md
   - docs/components/defaultparameters.md
   - docs/components/edgenetworktimeoutresponseerrordata.md
   - docs/components/effort.md
@@ -115,10 +132,11 @@ generatedFiles:
   - docs/components/filepath.md
   - docs/components/filepathtype.md
   - docs/components/forbiddenresponseerrordata.md
+  - docs/components/idautorouter.md
   - docs/components/idfileparser.md
   - docs/components/idmoderation.md
+  - docs/components/idresponsehealing.md
   - docs/components/idweb.md
-  - docs/components/ignore.md
   - docs/components/imagegenerationstatus.md
   - docs/components/imageurl.md
   - docs/components/inputmodality.md
@@ -127,10 +145,10 @@ generatedFiles:
   - docs/components/internalserverresponseerrordata.md
   - docs/components/jsonschemaconfig.md
   - docs/components/listendpointsresponse.md
-  - docs/components/maxprice.md
   - docs/components/message.md
   - docs/components/messagecontent.md
   - docs/components/messagedeveloper.md
+  - docs/components/modality.md
   - docs/components/model.md
   - docs/components/modelarchitecture.md
   - docs/components/modelarchitectureinstructtype.md
@@ -142,7 +160,6 @@ generatedFiles:
   - docs/components/namedtoolchoicefunction.md
   - docs/components/notfoundresponseerrordata.md
   - docs/components/object.md
-  - docs/components/only.md
   - docs/components/openairesponsesannotation.md
   - docs/components/openairesponsesincludable.md
   - docs/components/openairesponsesincompletedetails.md
@@ -241,6 +258,19 @@ generatedFiles:
   - docs/components/openresponsesreasoningsummarytextdoneeventtype.md
   - docs/components/openresponsesreasoningtype.md
   - docs/components/openresponsesrequest.md
+  - docs/components/openresponsesrequestignore.md
+  - docs/components/openresponsesrequestimageconfig.md
+  - docs/components/openresponsesrequestmaxprice.md
+  - docs/components/openresponsesrequestonly.md
+  - docs/components/openresponsesrequestorder.md
+  - docs/components/openresponsesrequestpluginautorouter.md
+  - docs/components/openresponsesrequestpluginfileparser.md
+  - docs/components/openresponsesrequestpluginmoderation.md
+  - docs/components/openresponsesrequestpluginresponsehealing.md
+  - docs/components/openresponsesrequestpluginunion.md
+  - docs/components/openresponsesrequestpluginweb.md
+  - docs/components/openresponsesrequestprovider.md
+  - docs/components/openresponsesrequestsort.md
   - docs/components/openresponsesrequesttoolfunction.md
   - docs/components/openresponsesrequesttoolunion.md
   - docs/components/openresponsesrequesttype.md
@@ -276,7 +306,6 @@ generatedFiles:
   - docs/components/openresponseswebsearchtool.md
   - docs/components/openresponseswebsearchtoolfilters.md
   - docs/components/openresponseswebsearchtooltype.md
-  - docs/components/order.md
   - docs/components/outputitemimagegenerationcall.md
   - docs/components/outputitemimagegenerationcalltype.md
   - docs/components/outputmessage.md
@@ -292,26 +321,43 @@ generatedFiles:
   - docs/components/parameter.md
   - docs/components/part1.md
   - docs/components/part2.md
+  - docs/components/partition.md
   - docs/components/payloadtoolargeresponseerrordata.md
   - docs/components/paymentrequiredresponseerrordata.md
   - docs/components/pdf.md
   - docs/components/pdfengine.md
+  - docs/components/pdfparserengine.md
+  - docs/components/pdfparseroptions.md
+  - docs/components/percentilelatencycutoffs.md
+  - docs/components/percentilestats.md
+  - docs/components/percentilethroughputcutoffs.md
   - docs/components/perrequestlimits.md
-  - docs/components/plugin.md
+  - docs/components/preferredmaxlatency.md
-  - docs/components/pluginfileparser.md
+  - docs/components/preferredminthroughput.md
-  - docs/components/pluginmoderation.md
-  - docs/components/pluginweb.md
   - docs/components/pricing.md
   - docs/components/prompt.md
   - docs/components/prompttokensdetails.md
-  - docs/components/provider.md
   - docs/components/providername.md
   - docs/components/provideroverloadedresponseerrordata.md
+  - docs/components/providerpreferences.md
+  - docs/components/providerpreferencesignore.md
+  - docs/components/providerpreferencesmaxprice.md
+  - docs/components/providerpreferencesonly.md
+  - docs/components/providerpreferencesorder.md
+  - docs/components/providerpreferencespartition.md
+  - docs/components/providerpreferencesprovidersort.md
+  - docs/components/providerpreferencesprovidersortconfig.md
+  - docs/components/providerpreferencessortunion.md
   - docs/components/providersort.md
+  - docs/components/providersortconfig.md
+  - docs/components/providersortconfigenum.md
+  - docs/components/providersortconfigunion.md
+  - docs/components/providersortunion.md
   - docs/components/publicendpoint.md
   - docs/components/publicendpointquantization.md
   - docs/components/publicpricing.md
   - docs/components/quantization.md
+  - docs/components/quantizations.md
   - docs/components/reason.md
   - docs/components/reasoning.md
   - docs/components/reasoningsummarytext.md
@@ -355,6 +401,7 @@ generatedFiles:
   - docs/components/responsesoutputitemfunctioncallstatusunion.md
   - docs/components/responsesoutputitemfunctioncalltype.md
   - docs/components/responsesoutputitemreasoning.md
+  - docs/components/responsesoutputitemreasoningformat.md
   - docs/components/responsesoutputitemreasoningstatuscompleted.md
   - docs/components/responsesoutputitemreasoningstatusincomplete.md
   - docs/components/responsesoutputitemreasoningstatusinprogress.md
@@ -368,6 +415,7 @@ generatedFiles:
   - docs/components/responsesoutputmessagestatusinprogress.md
   - docs/components/responsesoutputmessagestatusunion.md
   - docs/components/responsesoutputmessagetype.md
+  - docs/components/responsesoutputmodality.md
   - docs/components/responsessearchcontextsize.md
   - docs/components/responseswebsearchcalloutput.md
   - docs/components/responseswebsearchcalloutputtype.md
@@ -375,9 +423,18 @@ generatedFiles:
   - docs/components/responseswebsearchuserlocationtype.md
   - docs/components/responsetextconfig.md
   - docs/components/responsetextconfigverbosity.md
+  - docs/components/route.md
+  - docs/components/schema0.md
+  - docs/components/schema0enum.md
+  - docs/components/schema3.md
+  - docs/components/schema3reasoningencrypted.md
+  - docs/components/schema3reasoningsummary.md
+  - docs/components/schema3reasoningtext.md
+  - docs/components/schema5.md
   - docs/components/security.md
   - docs/components/servicetier.md
   - docs/components/serviceunavailableresponseerrordata.md
+  - docs/components/sortenum.md
   - docs/components/streamoptions.md
   - docs/components/systemmessage.md
   - docs/components/systemmessagecontent.md
@@ -391,6 +448,7 @@ generatedFiles:
   - docs/components/toplogprob.md
   - docs/components/topproviderinfo.md
   - docs/components/truncation.md
+  - docs/components/ttl.md
   - docs/components/type.md
   - docs/components/typeresponsecompleted.md
   - docs/components/typeresponsecontentpartadded.md
@@ -418,6 +476,7 @@ generatedFiles:
   - docs/components/variables.md
   - docs/components/videourl1.md
   - docs/components/videourl2.md
+  - docs/components/websearchengine.md
   - docs/components/websearchpreviewtooluserlocation.md
   - docs/components/websearchpreviewtooluserlocationtype.md
   - docs/components/websearchstatus.md
@@ -436,6 +495,7 @@ generatedFiles:
   - docs/errors/toomanyrequestsresponseerror.md
   - docs/errors/unauthorizedresponseerror.md
   - docs/errors/unprocessableentityresponseerror.md
+  - docs/models/internal/globals.md
   - docs/models/utils/retryconfig.md
   - docs/operations/apitype.md
   - docs/operations/calldata.md
@@ -450,7 +510,6 @@ generatedFiles:
   - docs/operations/createcoinbasechargeresponse.md
   - docs/operations/createcoinbasechargesecurity.md
   - docs/operations/createembeddingsdata.md
-  - docs/operations/createembeddingsprovider.md
   - docs/operations/createembeddingsrequest.md
   - docs/operations/createembeddingsresponse.md
   - docs/operations/createembeddingsresponsebody.md
@@ -467,6 +526,7 @@ generatedFiles:
   - docs/operations/exchangeauthcodeforapikeycodechallengemethod.md
   - docs/operations/exchangeauthcodeforapikeyrequest.md
   - docs/operations/exchangeauthcodeforapikeyresponse.md
+  - docs/operations/getcreditsdata.md
   - docs/operations/getcreditsresponse.md
   - docs/operations/getcurrentkeydata.md
   - docs/operations/getcurrentkeyresponse.md
@@ -478,13 +538,11 @@ generatedFiles:
   - docs/operations/getkeyresponse.md
   - docs/operations/getmodelsrequest.md
   - docs/operations/getparametersdata.md
-  - docs/operations/getparametersprovider.md
   - docs/operations/getparametersrequest.md
   - docs/operations/getparametersresponse.md
   - docs/operations/getparameterssecurity.md
   - docs/operations/getuseractivityrequest.md
   - docs/operations/getuseractivityresponse.md
-  - docs/operations/ignore.md
   - docs/operations/imageurl.md
   - docs/operations/input.md
   - docs/operations/inputunion.md
@@ -497,12 +555,9 @@ generatedFiles:
   - docs/operations/listprovidersresponse.md
   - docs/operations/listrequest.md
   - docs/operations/listresponse.md
-  - docs/operations/maxprice.md
   - docs/operations/metadata.md
   - docs/operations/object.md
   - docs/operations/objectembedding.md
-  - docs/operations/only.md
-  - docs/operations/order.md
   - docs/operations/ratelimit.md
   - docs/operations/sendchatcompletionrequestresponse.md
   - docs/operations/supportedparameter.md
@@ -545,15 +600,19 @@ generatedFiles:
   - src/openrouter/chat.py
   - src/openrouter/completions.py
   - src/openrouter/components/__init__.py
+  - src/openrouter/components/_schema0.py
+  - src/openrouter/components/_schema3.py
   - src/openrouter/components/activityitem.py
   - src/openrouter/components/assistantmessage.py
   - src/openrouter/components/badgatewayresponseerrordata.py
   - src/openrouter/components/badrequestresponseerrordata.py
+  - src/openrouter/components/chatcompletionfinishreason.py
   - src/openrouter/components/chaterror.py
   - src/openrouter/components/chatgenerationparams.py
   - src/openrouter/components/chatgenerationtokenusage.py
   - src/openrouter/components/chatmessagecontentitem.py
   - src/openrouter/components/chatmessagecontentitemaudio.py
+  - src/openrouter/components/chatmessagecontentitemcachecontrol.py
   - src/openrouter/components/chatmessagecontentitemimage.py
   - src/openrouter/components/chatmessagecontentitemtext.py
   - src/openrouter/components/chatmessagecontentitemvideo.py
@@ -562,6 +621,7 @@ generatedFiles:
   - src/openrouter/components/chatmessagetoolcall.py
   - src/openrouter/components/chatresponse.py
   - src/openrouter/components/chatresponsechoice.py
+  - src/openrouter/components/chatstreamingchoice.py
   - src/openrouter/components/chatstreamingmessagechunk.py
   - src/openrouter/components/chatstreamingmessagetoolcall.py
   - src/openrouter/components/chatstreamingresponsechunk.py
@@ -639,10 +699,20 @@ generatedFiles:
   - src/openrouter/components/parameter.py
   - src/openrouter/components/payloadtoolargeresponseerrordata.py
   - src/openrouter/components/paymentrequiredresponseerrordata.py
+  - src/openrouter/components/pdfparserengine.py
+  - src/openrouter/components/pdfparseroptions.py
+  - src/openrouter/components/percentilelatencycutoffs.py
+  - src/openrouter/components/percentilestats.py
+  - src/openrouter/components/percentilethroughputcutoffs.py
   - src/openrouter/components/perrequestlimits.py
+  - src/openrouter/components/preferredmaxlatency.py
+  - src/openrouter/components/preferredminthroughput.py
   - src/openrouter/components/providername.py
   - src/openrouter/components/provideroverloadedresponseerrordata.py
+  - src/openrouter/components/providerpreferences.py
   - src/openrouter/components/providersort.py
+  - src/openrouter/components/providersortconfig.py
+  - src/openrouter/components/providersortunion.py
   - src/openrouter/components/publicendpoint.py
   - src/openrouter/components/publicpricing.py
   - src/openrouter/components/quantization.py
@@ -668,6 +738,7 @@ generatedFiles:
   - src/openrouter/components/responsesoutputitemfunctioncall.py
   - src/openrouter/components/responsesoutputitemreasoning.py
   - src/openrouter/components/responsesoutputmessage.py
+  - src/openrouter/components/responsesoutputmodality.py
   - src/openrouter/components/responsessearchcontextsize.py
   - src/openrouter/components/responseswebsearchcalloutput.py
   - src/openrouter/components/responseswebsearchuserlocation.py
@@ -684,6 +755,7 @@ generatedFiles:
   - src/openrouter/components/unprocessableentityresponseerrordata.py
   - src/openrouter/components/urlcitation.py
   - src/openrouter/components/usermessage.py
+  - src/openrouter/components/websearchengine.py
   - src/openrouter/components/websearchpreviewtooluserlocation.py
   - src/openrouter/components/websearchstatus.py
   - src/openrouter/credits.py
@@ -711,6 +783,9 @@ generatedFiles:
   - src/openrouter/errors/unprocessableentityresponse_error.py
   - src/openrouter/generations.py
   - src/openrouter/httpclient.py
+  - src/openrouter/models/__init__.py
+  - src/openrouter/models/internal/__init__.py
+  - src/openrouter/models/internal/globals.py
   - src/openrouter/models_.py
   - src/openrouter/oauth.py
   - src/openrouter/operations/__init__.py
@@ -764,10 +839,10 @@ examples:
   createResponses:
     speakeasy-default-create-responses:
       requestBody:
-        application/json: {"input": [{"type": "message", "role": "user", "content": "Hello, how are you?"}], "tools": [{"type": "function", "name": "get_current_weather", "description": "Get the current weather in a given location", "parameters": {"type": "object", "properties": {"location": {"type": "string"}}}}], "model": "anthropic/claude-4.5-sonnet-20250929", "temperature": 0.7, "top_p": 0.9, "stream": false}
+        application/json: {"store": false, "service_tier": "auto", "stream": false}
       responses:
         "200":
-          application/json: {"id": "resp-abc123", "object": "response", "created_at": 1704067200, "model": "gpt-4", "status": "completed", "output": [{"id": "msg-abc123", "role": "assistant", "type": "message", "status": "completed", "content": [{"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}]}], "error": null, "incomplete_details": null, "usage": {"input_tokens": 10, "input_tokens_details": {"cached_tokens": 0}, "output_tokens": 25, "output_tokens_details": {"reasoning_tokens": 0}, "total_tokens": 35}, "max_output_tokens": null, "temperature": null, "top_p": null, "instructions": null, "metadata": null, "tools": [], "tool_choice": "auto", "parallel_tool_calls": true}
+          application/json: {"id": "resp-abc123", "object": "response", "created_at": 1704067200, "model": "gpt-4", "output": [{"id": "msg-abc123", "role": "assistant", "type": "message", "content": [{"type": "output_text", "text": "Hello! How can I help you today?"}]}], "error": null, "incomplete_details": null, "temperature": null, "top_p": null, "instructions": null, "metadata": null, "tools": [], "tool_choice": "auto", "parallel_tool_calls": true}
         "400":
           application/json: {"error": {"code": 400, "message": "Invalid request parameters"}}
         "401":
@@ -814,7 +889,7 @@ examples:
     speakeasy-default-get-credits:
       responses:
         "200":
-          application/json: {}
+          application/json: {"data": {"total_credits": 100.5, "total_usage": 25.75}}
         "401":
           application/json: {"error": {"code": 401, "message": "Missing Authentication header"}}
         "403":
@@ -839,7 +914,7 @@ examples:
   createEmbeddings:
     speakeasy-default-create-embeddings:
       requestBody:
-        application/json: {"input": "<value>", "model": "Taurus", "provider": {"data_collection": "allow", "zdr": true, "enforce_distillable_text": true, "order": ["OpenAI"], "only": ["OpenAI"], "ignore": ["OpenAI"], "quantizations": ["fp16"], "sort": "price"}}
+        application/json: {"input": "<value>", "model": "Taurus"}
       responses:
         "200":
           application/json: {"object": "list", "data": [], "model": "Land Cruiser"}
@@ -868,7 +943,7 @@ examples:
     speakeasy-default-list-embeddings-models:
       responses:
         "200":
-          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.", "pricing": {"prompt": "0.00003", "completion": "0.00006", "request": "0", "image": "0"}, "context_length": 8192, "architecture": {"tokenizer": "GPT", "instruct_type": "chatml", "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"context_length": 8192, "max_completion_tokens": 4096, "is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
+          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "pricing": {"prompt": "0.00003", "completion": "0.00006"}, "context_length": 8192, "architecture": {"modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
         "400":
           application/json: {"error": {"code": 400, "message": "Invalid request parameters"}}
         "500":
@@ -908,7 +983,7 @@ examples:
     speakeasy-default-get-models:
       responses:
         "200":
-          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.", "pricing": {"prompt": "0.00003", "completion": "0.00006", "request": "0", "image": "0"}, "context_length": 8192, "architecture": {"tokenizer": "GPT", "instruct_type": "chatml", "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"context_length": 8192, "max_completion_tokens": 4096, "is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
+          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "pricing": {"prompt": "0.00003", "completion": "0.00006"}, "context_length": 8192, "architecture": {"modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
         "400":
           application/json: {"error": {"code": 400, "message": "Invalid request parameters"}}
         "500":
@@ -917,7 +992,7 @@ examples:
     speakeasy-default-list-models-user:
       responses:
         "200":
-          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.", "pricing": {"prompt": "0.00003", "completion": "0.00006", "request": "0", "image": "0"}, "context_length": 8192, "architecture": {"tokenizer": "GPT", "instruct_type": "chatml", "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"context_length": 8192, "max_completion_tokens": 4096, "is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
+          application/json: {"data": [{"id": "openai/gpt-4", "canonical_slug": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "pricing": {"prompt": "0.00003", "completion": "0.00006"}, "context_length": 8192, "architecture": {"modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "top_provider": {"is_moderated": true}, "per_request_limits": null, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "default_parameters": null}]}
         "401":
           application/json: {"error": {"code": 401, "message": "Missing Authentication header"}}
         "500":
@@ -930,7 +1005,7 @@ examples:
           slug: "<value>"
       responses:
         "200":
-          application/json: {"data": {"id": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.", "architecture": {"tokenizer": "GPT", "instruct_type": "chatml", "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "endpoints": [{"name": "OpenAI: GPT-4", "model_name": "GPT-4", "context_length": 8192, "pricing": {"prompt": "0.00003", "completion": "0.00006", "request": "0", "image": "0"}, "provider_name": "OpenAI", "tag": "openai", "quantization": "fp16", "max_completion_tokens": 4096, "max_prompt_tokens": 8192, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "status": -3, "uptime_last_30m": 99.5, "supports_implicit_caching": true}]}}
+          application/json: {"data": {"id": "openai/gpt-4", "name": "GPT-4", "created": 1692901234, "description": "GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.", "architecture": {"tokenizer": "GPT", "instruct_type": "chatml", "modality": "text->text", "input_modalities": ["text"], "output_modalities": ["text"]}, "endpoints": [{"name": "OpenAI: GPT-4", "model_name": "GPT-4", "context_length": 8192, "pricing": {"prompt": "0.00003", "completion": "0.00006"}, "provider_name": "OpenAI", "tag": "openai", "quantization": "fp16", "max_completion_tokens": 4096, "max_prompt_tokens": 8192, "supported_parameters": ["temperature", "top_p", "max_tokens", "frequency_penalty", "presence_penalty"], "uptime_last_30m": 99.5, "supports_implicit_caching": true, "latency_last_30m": {"p50": 0.25, "p75": 0.35, "p90": 0.48, "p99": 0.85}, "throughput_last_30m": {"p50": 45.2, "p75": 38.5, "p90": 28.3, "p99": 15.1}}]}}
         "404":
           application/json: {"error": {"code": 404, "message": "Resource not found"}}
         "500":
@@ -939,7 +1014,7 @@ examples:
     speakeasy-default-list-endpoints-zdr:
       responses:
         "200":
-          application/json: {"data": [{"name": "OpenAI: GPT-4", "model_name": "GPT-4", "context_length": 8192, "pricing": {"prompt": "0.00003", "completion": "0.00006", "request": "0", "image": "0"}, "provider_name": "OpenAI", "tag": "openai", "quantization": "fp16", "max_completion_tokens": 4096, "max_prompt_tokens": 8192, "supported_parameters": ["temperature", "top_p", "max_tokens"], "status": 0, "uptime_last_30m": 99.5, "supports_implicit_caching": true}]}
+          application/json: {"data": [{"name": "OpenAI: GPT-4", "model_name": "GPT-4", "context_length": 8192, "pricing": {"prompt": "0.00003", "completion": "0.00006"}, "provider_name": "OpenAI", "tag": "openai", "quantization": "fp16", "max_completion_tokens": 4096, "max_prompt_tokens": 8192, "supported_parameters": ["temperature", "top_p", "max_tokens"], "uptime_last_30m": 99.5, "supports_implicit_caching": true, "latency_last_30m": {"p50": 25.5, "p75": 35.2, "p90": 48.7, "p99": 85.3}, "throughput_last_30m": {"p50": 25.5, "p75": 35.2, "p90": 48.7, "p99": 85.3}}]}
         "500":
           application/json: {"error": {"code": 500, "message": "Internal Server Error"}}
   getParameters:
@@ -961,7 +1036,7 @@ examples:
     speakeasy-default-list-providers:
       responses:
         "200":
-          application/json: {"data": [{"name": "OpenAI", "slug": "openai", "privacy_policy_url": "https://openai.com/privacy", "terms_of_service_url": "https://openai.com/terms", "status_page_url": "https://status.openai.com"}]}
+          application/json: {"data": [{"name": "OpenAI", "slug": "openai", "privacy_policy_url": "https://openai.com/privacy"}]}
         "500":
           application/json: {"error": {"code": 500, "message": "Internal Server Error"}}
   list:
@@ -972,7 +1047,7 @@ examples:
           offset: "0"
       responses:
         "200":
-          application/json: {"data": [{"hash": "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", "name": "My Production Key", "label": "Production API Key", "disabled": false, "limit": 100, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T15:45:00Z", "expires_at": "2027-12-31T23:59:59Z"}]}
+          application/json: {"data": [{"hash": "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", "name": "My Production Key", "label": "Production API Key", "disabled": false, "limit": 100, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T15:45:00Z"}]}
         "401":
           application/json: {"error": {"code": 401, "message": "Missing Authentication header"}}
         "429":
@@ -982,10 +1057,10 @@ examples:
   createKeys:
     speakeasy-default-create-keys:
       requestBody:
-        application/json: {"name": "My New API Key", "limit": 50, "limit_reset": "monthly", "include_byok_in_limit": true, "expires_at": "2027-12-31T23:59:59Z"}
+        application/json: {"name": "My New API Key"}
       responses:
         "201":
-          application/json: {"data": {"hash": "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", "name": "My New API Key", "label": "My New API Key", "disabled": false, "limit": 50, "limit_remaining": 50, "limit_reset": "monthly", "include_byok_in_limit": true, "usage": 0, "usage_daily": 0, "usage_weekly": 0, "usage_monthly": 0, "byok_usage": 0, "byok_usage_daily": 0, "byok_usage_weekly": 0, "byok_usage_monthly": 0, "created_at": "2025-08-24T10:30:00Z", "updated_at": null, "expires_at": "2027-12-31T23:59:59Z"}, "key": "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"}
+          application/json: {"data": {"hash": "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", "name": "My New API Key", "label": "My New API Key", "disabled": false, "limit": 50, "limit_remaining": 50, "limit_reset": "monthly", "include_byok_in_limit": true, "usage": 0, "usage_daily": 0, "usage_weekly": 0, "usage_monthly": 0, "byok_usage": 0, "byok_usage_daily": 0, "byok_usage_weekly": 0, "byok_usage_monthly": 0, "created_at": "2025-08-24T10:30:00Z", "updated_at": null}, "key": "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"}
         "400":
           application/json: {"error": {"code": 400, "message": "Invalid request parameters"}}
         "401":
@@ -1000,10 +1075,10 @@ examples:
         path:
           hash: "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"
       requestBody:
-        application/json: {"name": "Updated API Key Name", "disabled": false, "limit": 75, "limit_reset": "daily", "include_byok_in_limit": true}
+        application/json: {}
       responses:
         "200":
-          application/json: {"data": {"hash": "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", "name": "Updated API Key Name", "label": "Updated API Key Name", "disabled": false, "limit": 75, "limit_remaining": 49.5, "limit_reset": "daily", "include_byok_in_limit": true, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T16:00:00Z", "expires_at": null}}
+          application/json: {"data": {"hash": "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", "name": "Updated API Key Name", "label": "Updated API Key Name", "disabled": false, "limit": 75, "limit_remaining": 49.5, "limit_reset": "daily", "include_byok_in_limit": true, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T16:00:00Z"}}
         "400":
           application/json: {"error": {"code": 400, "message": "Invalid request parameters"}}
         "401":
@@ -1037,7 +1112,7 @@ examples:
           hash: "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"
       responses:
         "200":
-          application/json: {"data": {"hash": "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", "name": "My Production Key", "label": "Production API Key", "disabled": false, "limit": 100, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T15:45:00Z", "expires_at": "2027-12-31T23:59:59Z"}}
+          application/json: {"data": {"hash": "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", "name": "My Production Key", "label": "Production API Key", "disabled": false, "limit": 100, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "created_at": "2025-08-24T10:30:00Z", "updated_at": "2025-08-24T15:45:00Z"}}
         "401":
           application/json: {"error": {"code": 401, "message": "Missing Authentication header"}}
         "404":
@@ -1050,7 +1125,7 @@ examples:
     speakeasy-default-get-current-key:
       responses:
         "200":
-          application/json: {"data": {"label": "sk-or-v1-au78b3456789012345678901234567890", "limit": 100, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "is_free_tier": false, "is_provisioning_key": false, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "expires_at": "2027-12-31T23:59:59Z", "rate_limit": {"requests": 1000, "interval": "1h", "note": "This field is deprecated and safe to ignore."}}}
+          application/json: {"data": {"label": "sk-or-v1-au78b3456789012345678901234567890", "limit": 100, "usage": 25.5, "usage_daily": 25.5, "usage_weekly": 25.5, "usage_monthly": 25.5, "byok_usage": 17.38, "byok_usage_daily": 17.38, "byok_usage_weekly": 17.38, "byok_usage_monthly": 17.38, "is_free_tier": false, "is_provisioning_key": false, "limit_remaining": 74.5, "limit_reset": "monthly", "include_byok_in_limit": false, "rate_limit": {"requests": 1000, "interval": "1h", "note": "This field is deprecated and safe to ignore."}}}
         "401":
           application/json: {"error": {"code": 401, "message": "Missing Authentication header"}}
         "500":
@@ -1058,7 +1133,7 @@ examples:
   exchangeAuthCodeForAPIKey:
     speakeasy-default-exchange-auth-code-for-API-key:
       requestBody:
-        application/json: {"code": "auth_code_abc123def456", "code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk", "code_challenge_method": "S256"}
+        application/json: {"code": "auth_code_abc123def456"}
       responses:
         "200":
           application/json: {"key": "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", "user_id": "user_2yOPcMpKoQhcd4bVgSMlELRaIah"}
@@ -1071,7 +1146,7 @@ examples:
   createAuthKeysCode:
     speakeasy-default-create-auth-keys-code:
       requestBody:
-        application/json: {"callback_url": "https://myapp.com/auth/callback", "code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM", "code_challenge_method": "S256", "limit": 100}
+        application/json: {"callback_url": "https://myapp.com/auth/callback"}
       responses:
         "200":
           application/json: {"data": {"id": "auth_code_xyz789", "app_id": 12345, "created_at": "2025-08-24T10:30:00Z"}}

.speakeasy/gen.yaml

@@ -6,7 +6,7 @@ generation:
   sdkClassName: OpenRouter
   maintainOpenAPIOrder: true
   usageSnippets:
-    optionalPropertyRendering: withExample
+    optionalPropertyRendering: never
     sdkInitStyle: constructor
   useClassNamesForArrayFields: true
   fixes:
@@ -24,13 +24,14 @@ generation:
   sdkHooksConfigAccess: true
   schemas:
     allOfMergeStrategy: shallowMerge
-  requestBodyFieldName: body
+  requestBodyFieldName: ""
   tests:
     generateTests: false
     generateNewTests: true
     skipResponseBodyAssertions: false
+  preApplyUnionDiscriminators: true
 python:
-  version: 0.0.19
+  version: 0.0.17
   additionalDependencies:
     dev: {}
     main: {}
@@ -38,6 +39,8 @@ python:
     - id
     - object
     - input
+    - models
+    - hash
   asyncMode: both
   authors:
     - OpenRouter
@@ -57,17 +60,20 @@ python:
   imports:
     option: openapi
     paths:
-      callbacks: ""
+      callbacks: callbacks
       errors: errors
       operations: operations
       shared: components
-      webhooks: ""
+      webhooks: webhooks
+  inferSSEOverload: true
+  inferUnionDiscriminators: true
   inputModelSuffix: input
   legacyPyright: false
   license: Apache-2.0
   maxMethodParams: 999
   methodArguments: infer-optional-args
   moduleName: ""
+  multipartArrayFormat: legacy
   outputModelSuffix: output
   packageManager: uv
   packageName: openrouter

.speakeasy/lint.yaml

@@ -0,0 +1,10 @@
+lintVersion: 1.0.0
+defaultRuleset: openrouter
+rulesets:
+  openrouter:
+    rulesets:
+      - speakeasy-recommended
+      - speakeasy-generation
+    rules:
+      oas3-missing-example:
+        severity: "off"

.speakeasy/overlays/add-headers.overlay.yaml

@@ -0,0 +1,35 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Add HTTP-Referer and X-Title as global parameters
+  version: 0.0.0
+actions:
+  # Add global parameters for app identification
+  - target: $
+    description: Add x-speakeasy-globals for HTTP-Referer and X-Title headers
+    update:
+      x-speakeasy-globals:
+        parameters:
+          - $ref: "#/components/parameters/AppIdentifier"
+          - $ref: "#/components/parameters/AppDisplayName"
+
+  # Add component parameters
+  - target: $.components
+    description: Add parameters for app identification headers
+    update:
+      parameters:
+        AppIdentifier:
+          name: HTTP-Referer
+          in: header
+          schema:
+            type: string
+          description: |
+            The app identifier should be your app's URL and is used as the primary identifier for rankings.
+            This is used to track API usage per application.
+        AppDisplayName:
+          name: X-Title
+          in: header
+          schema:
+            type: string
+          description: |
+            The app display name allows you to customize how your app appears in OpenRouter's dashboard.

.speakeasy/overlays/open-enums.overlay.yaml

@@ -0,0 +1,10 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Add open enums
+  version: 0.0.0
+actions:
+  - target: $..[?length(@.enum) > 1]
+    description: Automatically open all enums that have length > 1
+    update:
+      x-speakeasy-unknown-values: allow

.speakeasy/overlays/remove-rss-responses.overlay.yaml

@@ -0,0 +1,15 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Remove RSS+XML response schemas and related parameters
+  version: 0.0.0
+actions:
+  - target: $..responses.*.content["application/rss+xml"]
+    description: Remove application/rss+xml response schemas
+    remove: true
+  - target: $..parameters[?@.name == "use_rss"]
+    description: Remove use_rss parameter
+    remove: true
+  - target: $..parameters[?@.name == "use_rss_chat_links"]
+    description: Remove use_rss_chat_links parameter
+    remove: true

.speakeasy/workflow.lock

@@ -1,37 +1,51 @@
-speakeasyVersion: 1.658.2
+speakeasyVersion: 1.666.0
 sources:
     -OAS:
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:fc0c90dc8ebb69ef4a571e4e63dcd7f8f33c3254c17ad2583b628fbbf3d1ac05
+        sourceRevisionDigest: sha256:01256c8494de6bfc13c36d82ae316a6a13d402194f844618bcd4d59e34f325f3
-        sourceBlobDigest: sha256:635d63fd18db468c1dcc23700382af788de76594ba3b8292fae9b14c0e5c22c4
+        sourceBlobDigest: sha256:4c80e48fd5e1cd030e68d664eb93984b4d5946867252ff1755a2bd2a05eccd4e
         tags:
             - latest
+    OpenRouter API:
+        sourceNamespace: open-router-chat-completions-api
+        sourceRevisionDigest: sha256:5615c05050362c0944a59e3b5b0437157f9d152faac1509d3c390bbc85e93b1e
+        sourceBlobDigest: sha256:4f08bbf0b65fd4e617996964ccb1fa33ed7e807f81d8731ba4d00b0a7fd2da98
+        tags:
+            - latest
+            - subtree-sync-import-python-sdk
+            - 1.0.0
 targets:
     open-router:
-        source: -OAS
+        source: OpenRouter API
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:fc0c90dc8ebb69ef4a571e4e63dcd7f8f33c3254c17ad2583b628fbbf3d1ac05
+        sourceRevisionDigest: sha256:5615c05050362c0944a59e3b5b0437157f9d152faac1509d3c390bbc85e93b1e
-        sourceBlobDigest: sha256:635d63fd18db468c1dcc23700382af788de76594ba3b8292fae9b14c0e5c22c4
+        sourceBlobDigest: sha256:4f08bbf0b65fd4e617996964ccb1fa33ed7e807f81d8731ba4d00b0a7fd2da98
+        codeSamplesNamespace: open-router-python-code-samples
+        codeSamplesRevisionDigest: sha256:c60fe0121ecdbfb79af3a344b52b8daade826fb9648b925f229e5b1d93b5c7ac
 workflow:
     workflowVersion: 1.0.0
-    speakeasyVersion: latest
+    speakeasyVersion: 1.666.0
     sources:
-        -OAS:
+        OpenRouter API:
             inputs:
-                - location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api:main
+                - location: .speakeasy/in.openapi.yaml
+            overlays:
+                - location: .speakeasy/overlays/open-enums.overlay.yaml
+                - location: .speakeasy/overlays/remove-rss-responses.overlay.yaml
+                - location: .speakeasy/overlays/add-headers.overlay.yaml
             output: .speakeasy/out.openapi.yaml
             registry:
-                location: registry.speakeasyapi.dev/openrouter/sdk/-oas
+                location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api
     targets:
         open-router:
             target: python
-            source: -OAS
+            source: OpenRouter API
             publish:
                 pypi:
                     token: $pypi_token
             codeSamples:
                 registry:
-                    location: registry.speakeasyapi.dev/openrouter/sdk/-oas-python-code-samples
+                    location: registry.speakeasyapi.dev/openrouter/sdk/open-router-python-code-samples
                 labelOverride:
                     fixedValue: Python (SDK)
                 blocking: false

.speakeasy/workflow.yaml

@@ -1,22 +1,26 @@
 workflowVersion: 1.0.0
-speakeasyVersion: latest
+speakeasyVersion: 1.666.0
 sources:
-    -OAS:
+    OpenRouter API:
         inputs:
-            - location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api:main
+            - location: .speakeasy/in.openapi.yaml
+        overlays:
+            - location: .speakeasy/overlays/open-enums.overlay.yaml
+            - location: .speakeasy/overlays/remove-rss-responses.overlay.yaml
+            - location: .speakeasy/overlays/add-headers.overlay.yaml
         output: .speakeasy/out.openapi.yaml
         registry:
-            location: registry.speakeasyapi.dev/openrouter/sdk/-oas
+            location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api
 targets:
     open-router:
         target: python
-        source: -OAS
+        source: OpenRouter API
         publish:
             pypi:
                 token: $pypi_token
         codeSamples:
             registry:
-                location: registry.speakeasyapi.dev/openrouter/sdk/-oas-python-code-samples
+                location: registry.speakeasyapi.dev/openrouter/sdk/open-router-python-code-samples
             labelOverride:
                 fixedValue: Python (SDK)
             blocking: false

USAGE.md

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

docs/components/chatgenerationparams.md

@@ -3,27 +3,34 @@
 
 ## Fields
 
-| Field                                                                                                                    | Type                                                                                                                     | Required                                                                                                                 | Description                                                                                                              |
+| Field                                                                                                                                                                                                                                       | Type                                                                                                                                                                                                                                        | Required                                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                 |
-| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `messages`                                                                                                               | List[[components.Message](../components/message.md)]                                                                     | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |
+| `provider`                                                                                                                                                                                                                                  | [OptionalNullable[components.ChatGenerationParamsProvider]](../components/chatgenerationparamsprovider.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                          | When multiple model providers are available, optionally indicate your routing preference.                                                                                                                                                   |
-| `model`                                                                                                                  | *Optional[str]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `plugins`                                                                                                                                                                                                                                   | List[[components.ChatGenerationParamsPluginUnion](../components/chatgenerationparamspluginunion.md)]                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                          | Plugins you want to enable for this request, including their settings.                                                                                                                                                                      |
-| `models`                                                                                                                 | List[*str*]                                                                                                              | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `route`                                                                                                                                                                                                                                     | [OptionalNullable[components.Route]](../components/route.md)                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `frequency_penalty`                                                                                                      | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `user`                                                                                                                                                                                                                                      | *Optional[str]*                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `logit_bias`                                                                                                             | Dict[str, *float*]                                                                                                       | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `session_id`                                                                                                                                                                                                                                | *Optional[str]*                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                          | A unique identifier for grouping related requests (e.g., a conversation or agent workflow) for observability. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 128 characters. |
-| `logprobs`                                                                                                               | *OptionalNullable[bool]*                                                                                                 | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `messages`                                                                                                                                                                                                                                  | List[[components.Message](../components/message.md)]                                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `top_logprobs`                                                                                                           | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `model`                                                                                                                                                                                                                                     | *Optional[str]*                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `max_completion_tokens`                                                                                                  | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `models`                                                                                                                                                                                                                                    | List[*str*]                                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `max_tokens`                                                                                                             | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `frequency_penalty`                                                                                                                                                                                                                         | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `metadata`                                                                                                               | Dict[str, *str*]                                                                                                         | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `logit_bias`                                                                                                                                                                                                                                | Dict[str, *float*]                                                                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `presence_penalty`                                                                                                       | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `logprobs`                                                                                                                                                                                                                                  | *OptionalNullable[bool]*                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `reasoning`                                                                                                              | [Optional[components.Reasoning]](../components/reasoning.md)                                                             | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `top_logprobs`                                                                                                                                                                                                                              | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `response_format`                                                                                                        | [Optional[components.ChatGenerationParamsResponseFormatUnion]](../components/chatgenerationparamsresponseformatunion.md) | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `max_completion_tokens`                                                                                                                                                                                                                     | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `seed`                                                                                                                   | *OptionalNullable[int]*                                                                                                  | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `max_tokens`                                                                                                                                                                                                                                | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `stop`                                                                                                                   | [OptionalNullable[components.ChatGenerationParamsStop]](../components/chatgenerationparamsstop.md)                       | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `metadata`                                                                                                                                                                                                                                  | Dict[str, *str*]                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `stream`                                                                                                                 | *Optional[bool]*                                                                                                         | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `presence_penalty`                                                                                                                                                                                                                          | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `stream_options`                                                                                                         | [OptionalNullable[components.ChatStreamOptions]](../components/chatstreamoptions.md)                                     | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `reasoning`                                                                                                                                                                                                                                 | [Optional[components.Reasoning]](../components/reasoning.md)                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `temperature`                                                                                                            | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `response_format`                                                                                                                                                                                                                           | [Optional[components.ChatGenerationParamsResponseFormatUnion]](../components/chatgenerationparamsresponseformatunion.md)                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `tool_choice`                                                                                                            | *Optional[Any]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `seed`                                                                                                                                                                                                                                      | *OptionalNullable[int]*                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `tools`                                                                                                                  | List[[components.ToolDefinitionJSON](../components/tooldefinitionjson.md)]                                               | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `stop`                                                                                                                                                                                                                                      | [OptionalNullable[components.ChatGenerationParamsStop]](../components/chatgenerationparamsstop.md)                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `top_p`                                                                                                                  | *OptionalNullable[float]*                                                                                                | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `stream`                                                                                                                                                                                                                                    | *Optional[bool]*                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
-| `user`                                                                                                                   | *Optional[str]*                                                                                                          | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `stream_options`                                                                                                                                                                                                                            | [OptionalNullable[components.ChatStreamOptions]](../components/chatstreamoptions.md)                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `temperature`                                                                                                                                                                                                                               | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `tool_choice`                                                                                                                                                                                                                               | *Optional[Any]*                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `tools`                                                                                                                                                                                                                                     | List[[components.ToolDefinitionJSON](../components/tooldefinitionjson.md)]                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `top_p`                                                                                                                                                                                                                                     | *OptionalNullable[float]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `debug`                                                                                                                                                                                                                                     | [Optional[components.Debug]](../components/debug.md)                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `image_config`                                                                                                                                                                                                                              | Dict[str, [components.ChatGenerationParamsImageConfig](../components/chatgenerationparamsimageconfig.md)]                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |
+| `modalities`                                                                                                                                                                                                                                | List[[components.Modality](../components/modality.md)]                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                                         |

docs/components/chatgenerationparamsdatacollection.md

@@ -0,0 +1,9 @@
+# ChatGenerationParamsDataCollection
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `DENY`  | deny    |
+| `ALLOW` | allow   |

docs/components/chatgenerationparamsengine.md

@@ -0,0 +1,9 @@
+# ChatGenerationParamsEngine
+
+
+## Values
+
+| Name     | Value    |
+| -------- | -------- |
+| `NATIVE` | native   |
+| `EXA`    | exa      |

docs/components/chatgenerationparamsimageconfig.md

@@ -0,0 +1,17 @@
+# ChatGenerationParamsImageConfig
+
+
+## Supported Types
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+

docs/components/chatgenerationparamsmaxprice.md

@@ -0,0 +1,14 @@
+# ChatGenerationParamsMaxPrice
+
+The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion.
+
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `prompt`           | *Optional[Any]*    | :heavy_minus_sign: | N/A                |
+| `completion`       | *Optional[Any]*    | :heavy_minus_sign: | N/A                |
+| `image`            | *Optional[Any]*    | :heavy_minus_sign: | N/A                |
+| `audio`            | *Optional[Any]*    | :heavy_minus_sign: | N/A                |
+| `request`          | *Optional[Any]*    | :heavy_minus_sign: | N/A                |

docs/components/chatgenerationparamspdf.md

@@ -0,0 +1,8 @@
+# ChatGenerationParamsPdf
+
+
+## Fields
+
+| Field                                                                                                | Type                                                                                                 | Required                                                                                             | Description                                                                                          |
+| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `engine`                                                                                             | [Optional[components.ChatGenerationParamsPdfEngine]](../components/chatgenerationparamspdfengine.md) | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |

docs/components/chatgenerationparamspdfengine.md

@@ -0,0 +1,10 @@
+# ChatGenerationParamsPdfEngine
+
+
+## Values
+
+| Name          | Value         |
+| ------------- | ------------- |
+| `MISTRAL_OCR` | mistral-ocr   |
+| `PDF_TEXT`    | pdf-text      |
+| `NATIVE`      | native        |

docs/components/chatgenerationparamspluginautorouter.md

@@ -0,0 +1,10 @@
+# ChatGenerationParamsPluginAutoRouter
+
+
+## Fields
+
+| Field                    | Type                     | Required                 | Description              |
+| ------------------------ | ------------------------ | ------------------------ | ------------------------ |
+| `id`                     | *Literal["auto-router"]* | :heavy_check_mark:       | N/A                      |
+| `enabled`                | *Optional[bool]*         | :heavy_minus_sign:       | N/A                      |
+| `allowed_models`         | List[*str*]              | :heavy_minus_sign:       | N/A                      |

docs/components/chatgenerationparamspluginfileparser.md

@@ -0,0 +1,10 @@
+# ChatGenerationParamsPluginFileParser
+
+
+## Fields
+
+| Field                                            | Type                                             | Required                                         | Description                                      |
+| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
+| `id`                                             | *Literal["file-parser"]*                         | :heavy_check_mark:                               | N/A                                              |
+| `enabled`                                        | *Optional[bool]*                                 | :heavy_minus_sign:                               | N/A                                              |
+| `pdf`                                            | [Optional[components.Pdf]](../components/pdf.md) | :heavy_minus_sign:                               | N/A                                              |

docs/components/chatgenerationparamspluginmoderation.md

@@ -0,0 +1,8 @@
+# ChatGenerationParamsPluginModeration
+
+
+## Fields
+
+| Field                   | Type                    | Required                | Description             |
+| ----------------------- | ----------------------- | ----------------------- | ----------------------- |
+| `id`                    | *Literal["moderation"]* | :heavy_check_mark:      | N/A                     |

docs/components/chatgenerationparamspluginresponsehealing.md

@@ -0,0 +1,9 @@
+# ChatGenerationParamsPluginResponseHealing
+
+
+## Fields
+
+| Field                         | Type                          | Required                      | Description                   |
+| ----------------------------- | ----------------------------- | ----------------------------- | ----------------------------- |
+| `id`                          | *Literal["response-healing"]* | :heavy_check_mark:            | N/A                           |
+| `enabled`                     | *Optional[bool]*              | :heavy_minus_sign:            | N/A                           |

docs/components/chatgenerationparamspluginunion.md

@@ -0,0 +1,35 @@
+# ChatGenerationParamsPluginUnion
+
+
+## Supported Types
+
+### `components.ChatGenerationParamsPluginAutoRouter`
+
+```python
+value: components.ChatGenerationParamsPluginAutoRouter = /* values here */
+```
+
+### `components.ChatGenerationParamsPluginModeration`
+
+```python
+value: components.ChatGenerationParamsPluginModeration = /* values here */
+```
+
+### `components.ChatGenerationParamsPluginWeb`
+
+```python
+value: components.ChatGenerationParamsPluginWeb = /* values here */
+```
+
+### `components.ChatGenerationParamsPluginFileParser`
+
+```python
+value: components.ChatGenerationParamsPluginFileParser = /* values here */
+```
+
+### `components.ChatGenerationParamsPluginResponseHealing`
+
+```python
+value: components.ChatGenerationParamsPluginResponseHealing = /* values here */
+```
+

docs/components/chatgenerationparamspluginweb.md

@@ -1,11 +1,12 @@
-# PluginWeb
+# ChatGenerationParamsPluginWeb
 
 
 ## Fields
 
 | Field                                                  | Type                                                   | Required                                               | Description                                            |
 | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ |
-| `id`                                                   | [components.IDWeb](../components/idweb.md)             | :heavy_check_mark:                                     | N/A                                                    |
+| `id`                                                   | *Literal["web"]*                                       | :heavy_check_mark:                                     | N/A                                                    |
+| `enabled`                                              | *Optional[bool]*                                       | :heavy_minus_sign:                                     | N/A                                                    |
 | `max_results`                                          | *Optional[float]*                                      | :heavy_minus_sign:                                     | N/A                                                    |
 | `search_prompt`                                        | *Optional[str]*                                        | :heavy_minus_sign:                                     | N/A                                                    |
 | `engine`                                               | [Optional[components.Engine]](../components/engine.md) | :heavy_minus_sign:                                     | N/A                                                    |

docs/components/chatgenerationparamspreferredmaxlatency.md

@@ -0,0 +1,11 @@
+# ChatGenerationParamsPreferredMaxLatency
+
+
+## Fields
+
+| Field                     | Type                      | Required                  | Description               |
+| ------------------------- | ------------------------- | ------------------------- | ------------------------- |
+| `p50`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p75`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p90`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p99`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |

docs/components/chatgenerationparamspreferredmaxlatencyunion.md

@@ -0,0 +1,17 @@
+# ChatGenerationParamsPreferredMaxLatencyUnion
+
+
+## Supported Types
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+
+### `components.ChatGenerationParamsPreferredMaxLatency`
+
+```python
+value: components.ChatGenerationParamsPreferredMaxLatency = /* values here */
+```
+

docs/components/chatgenerationparamspreferredminthroughput.md

@@ -0,0 +1,11 @@
+# ChatGenerationParamsPreferredMinThroughput
+
+
+## Fields
+
+| Field                     | Type                      | Required                  | Description               |
+| ------------------------- | ------------------------- | ------------------------- | ------------------------- |
+| `p50`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p75`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p90`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |
+| `p99`                     | *OptionalNullable[float]* | :heavy_minus_sign:        | N/A                       |

docs/components/chatgenerationparamspreferredminthroughputunion.md

@@ -0,0 +1,17 @@
+# ChatGenerationParamsPreferredMinThroughputUnion
+
+
+## Supported Types
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+
+### `components.ChatGenerationParamsPreferredMinThroughput`
+
+```python
+value: components.ChatGenerationParamsPreferredMinThroughput = /* values here */
+```
+

docs/components/chatgenerationparamsprovider.md

@@ -1,20 +1,20 @@
-# Provider
+# ChatGenerationParamsProvider
-
-When multiple model providers are available, optionally indicate your routing preference.
 
 
 ## Fields
 
-| Field                                                                                                                                                                                                                                                                                | Type                                                                                                                                                                                                                                                                                 | Required                                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                                                                          | Example                                                                                                                                                                                                                                                                              |
+| Field                                                                                                                                                                                                                                                                                                                                                     | Type                                                                                                                                                                                                                                                                                                                                                      | Required                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                               |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `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/> |                                                                                                                                                                                                                                                                                      |
+| `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.                                                                |                                                                                                                                                                                                                                                                                      |
+| `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                                                                                                                                                                                                                                                                                |
+| `data_collection`                                                                                                                                                                                                                                                                                                                                         | [OptionalNullable[components.ChatGenerationParamsDataCollection]](../components/chatgenerationparamsdatacollection.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.                                                                    |
-| `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                                                                                                                                                                                                                                                                                 |
+| `zdr`                                                                                                                                                                                                                                                                                                                                                     | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | N/A                                                                                                                                                                                                                                                                                                                                                       |
-| `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                                                                                                                                                                                                                                                                                 |
+| `enforce_distillable_text`                                                                                                                                                                                                                                                                                                                                | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | N/A                                                                                                                                                                                                                                                                                                                                                       |
-| `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.      |                                                                                                                                                                                                                                                                                      |
+| `order`                                                                                                                                                                                                                                                                                                                                                   | List[[components.Schema0](../components/schema0.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.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.                                                                                                                                                 |                                                                                                                                                                                                                                                                                      |
+| `only`                                                                                                                                                                                                                                                                                                                                                    | List[[components.Schema0](../components/schema0.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.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.                                                                                                                                                |                                                                                                                                                                                                                                                                                      |
+| `ignore`                                                                                                                                                                                                                                                                                                                                                  | List[[components.Schema0](../components/schema0.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.                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                      |
+| `quantizations`                                                                                                                                                                                                                                                                                                                                           | List[[components.Quantizations](../components/quantizations.md)]                                                                                                                                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | A list of quantization levels to filter the provider by.                                                                                                                                                                                                                                                                                                  |
-| `sort`                                                                                                                                                                                                                                                                               | [OptionalNullable[components.ProviderSort]](../components/providersort.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                                                                                                                                                                                                                                                                                |
+| `sort`                                                                                                                                                                                                                                                                                                                                                    | [OptionalNullable[components.ProviderSortUnion]](../components/providersortunion.md)                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                        | The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is performed.                                                                                                                                                                                                                                      |
-| `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.                                                                                                                                                   |                                                                                                                                                                                                                                                                                      |
+| `max_price`                                                                                                                                                                                                                                                                                                                                               | [Optional[components.ChatGenerationParamsMaxPrice]](../components/chatgenerationparamsmaxprice.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.                                                                                                                                                                                                                        |
+| `preferred_min_throughput`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.ChatGenerationParamsPreferredMinThroughputUnion]](../components/chatgenerationparamspreferredminthroughputunion.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. |
+| `preferred_max_latency`                                                                                                                                                                                                                                                                                                                                   | [OptionalNullable[components.ChatGenerationParamsPreferredMaxLatencyUnion]](../components/chatgenerationparamspreferredmaxlatencyunion.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.              |

docs/components/chatgenerationparamsroute.md

@@ -0,0 +1,9 @@
+# ChatGenerationParamsRoute
+
+
+## Values
+
+| Name       | Value      |
+| ---------- | ---------- |
+| `FALLBACK` | fallback   |
+| `SORT`     | sort       |

docs/components/chatmessagecontentitemaudioformat.md

@@ -1,14 +0,0 @@
-# ChatMessageContentItemAudioFormat
-
-
-## Values
-
-| Name    | Value   |
-| ------- | ------- |
-| `WAV`   | wav     |
-| `MP3`   | mp3     |
-| `FLAC`  | flac    |
-| `M4A`   | m4a     |
-| `OGG`   | ogg     |
-| `PCM16` | pcm16   |
-| `PCM24` | pcm24   |

docs/components/chatmessagecontentitemaudioinputaudio.md

@@ -3,7 +3,7 @@
 
 ## Fields
 
-| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
+| Field              | Type               | Required           | Description        |
-| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| ------------------ | ------------------ | ------------------ | ------------------ |
-| `data`                                                                                             | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `data`             | *str*              | :heavy_check_mark: | N/A                |
-| `format_`                                                                                          | [components.ChatMessageContentItemAudioFormat](../components/chatmessagecontentitemaudioformat.md) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `format_`          | *str*              | :heavy_check_mark: | N/A                |

docs/components/chatmessagecontentitemcachecontrol.md

@@ -0,0 +1,9 @@
+# ChatMessageContentItemCacheControl
+
+
+## Fields
+
+| Field                                            | Type                                             | Required                                         | Description                                      |
+| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
+| `type`                                           | *Literal["ephemeral"]*                           | :heavy_check_mark:                               | N/A                                              |
+| `ttl`                                            | [Optional[components.TTL]](../components/ttl.md) | :heavy_minus_sign:                               | N/A                                              |

docs/components/chatmessagecontentitemtext.md

@@ -3,7 +3,8 @@
 
 ## Fields
 
-| Field              | Type               | Required           | Description        |
+| Field                                                                                                          | Type                                                                                                           | Required                                                                                                       | Description                                                                                                    |
-| ------------------ | ------------------ | ------------------ | ------------------ |
+| -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `type`             | *Literal["text"]*  | :heavy_check_mark: | N/A                |
+| `type`                                                                                                         | *Literal["text"]*                                                                                              | :heavy_check_mark:                                                                                             | N/A                                                                                                            |
-| `text`             | *str*              | :heavy_check_mark: | N/A                |
+| `text`                                                                                                         | *str*                                                                                                          | :heavy_check_mark:                                                                                             | N/A                                                                                                            |
+| `cache_control`                                                                                                | [Optional[components.ChatMessageContentItemCacheControl]](../components/chatmessagecontentitemcachecontrol.md) | :heavy_minus_sign:                                                                                             | N/A                                                                                                            |

docs/components/chatresponsechoice.md

@@ -8,4 +8,5 @@
 | `finish_reason`                                                                                    | [Nullable[components.ChatCompletionFinishReason]](../components/chatcompletionfinishreason.md)     | :heavy_check_mark:                                                                                 | N/A                                                                                                |
 | `index`                                                                                            | *float*                                                                                            | :heavy_check_mark:                                                                                 | N/A                                                                                                |
 | `message`                                                                                          | [components.AssistantMessage](../components/assistantmessage.md)                                   | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `reasoning_details`                                                                                | List[[components.Schema3](../components/schema3.md)]                                               | :heavy_minus_sign:                                                                                 | N/A                                                                                                |
 | `logprobs`                                                                                         | [OptionalNullable[components.ChatMessageTokenLogprobs]](../components/chatmessagetokenlogprobs.md) | :heavy_minus_sign:                                                                                 | N/A                                                                                                |

docs/components/chatstreamingmessagechunk.md

@@ -10,3 +10,4 @@
 | `reasoning`                                                                                          | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
 | `refusal`                                                                                            | *OptionalNullable[str]*                                                                              | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
 | `tool_calls`                                                                                         | List[[components.ChatStreamingMessageToolCall](../components/chatstreamingmessagetoolcall.md)]       | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |
+| `reasoning_details`                                                                                  | List[[components.Schema3](../components/schema3.md)]                                                 | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |

docs/components/completionchoice.md

@@ -9,3 +9,5 @@
 | `index`                                                                                | *float*                                                                                | :heavy_check_mark:                                                                     | N/A                                                                                    |
 | `logprobs`                                                                             | [Nullable[components.CompletionLogprobs]](../components/completionlogprobs.md)         | :heavy_check_mark:                                                                     | N/A                                                                                    |
 | `finish_reason`                                                                        | [Nullable[components.CompletionFinishReason]](../components/completionfinishreason.md) | :heavy_check_mark:                                                                     | N/A                                                                                    |
+| `native_finish_reason`                                                                 | *Optional[str]*                                                                        | :heavy_minus_sign:                                                                     | N/A                                                                                    |
+| `reasoning`                                                                            | *OptionalNullable[str]*                                                                | :heavy_minus_sign:                                                                     | N/A                                                                                    |

docs/components/completionresponse.md

@@ -9,6 +9,7 @@
 | `object`                                                                 | *Literal["text_completion"]*                                             | :heavy_check_mark:                                                       | N/A                                                                      |
 | `created`                                                                | *float*                                                                  | :heavy_check_mark:                                                       | N/A                                                                      |
 | `model`                                                                  | *str*                                                                    | :heavy_check_mark:                                                       | N/A                                                                      |
+| `provider`                                                               | *Optional[str]*                                                          | :heavy_minus_sign:                                                       | N/A                                                                      |
 | `system_fingerprint`                                                     | *Optional[str]*                                                          | :heavy_minus_sign:                                                       | N/A                                                                      |
 | `choices`                                                                | List[[components.CompletionChoice](../components/completionchoice.md)]   | :heavy_check_mark:                                                       | N/A                                                                      |
 | `usage`                                                                  | [Optional[components.CompletionUsage]](../components/completionusage.md) | :heavy_minus_sign:                                                       | N/A                                                                      |

docs/components/debug.md

@@ -0,0 +1,8 @@
+# Debug
+
+
+## Fields
+
+| Field                | Type                 | Required             | Description          |
+| -------------------- | -------------------- | -------------------- | -------------------- |
+| `echo_upstream_body` | *Optional[bool]*     | :heavy_minus_sign:   | N/A                  |

docs/components/effort.md

@@ -5,8 +5,9 @@
 
 | Name      | Value     |
 | --------- | --------- |
-| `NONE`    | none      |
+| `XHIGH`   | xhigh     |
-| `MINIMAL` | minimal   |
-| `LOW`     | low       |
-| `MEDIUM`  | medium    |
 | `HIGH`    | high      |
+| `MEDIUM`  | medium    |
+| `LOW`     | low       |
+| `MINIMAL` | minimal   |
+| `NONE`    | none      |

docs/components/idautorouter.md

@@ -0,0 +1,8 @@
+# IDAutoRouter
+
+
+## Values
+
+| Name          | Value         |
+| ------------- | ------------- |
+| `AUTO_ROUTER` | auto-router   |

docs/components/idresponsehealing.md

@@ -0,0 +1,8 @@
+# IDResponseHealing
+
+
+## Values
+
+| Name               | Value              |
+| ------------------ | ------------------ |
+| `RESPONSE_HEALING` | response-healing   |

docs/components/maxprice.md

@@ -1,14 +0,0 @@
-# MaxPrice
-
-The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion.
-
-
-## Fields
-
-| Field                                                     | Type                                                      | Required                                                  | Description                                               |
-| --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- |
-| `prompt`                                                  | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `completion`                                              | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `image`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `audio`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
-| `request`                                                 | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |

docs/components/modality.md

@@ -0,0 +1,9 @@
+# Modality
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `TEXT`  | text    |
+| `IMAGE` | image   |

docs/components/openairesponsesreasoningeffort.md

@@ -5,6 +5,7 @@
 
 | Name      | Value     |
 | --------- | --------- |
+| `XHIGH`   | xhigh     |
 | `HIGH`    | high      |
 | `MEDIUM`  | medium    |
 | `LOW`     | low       |

docs/components/openresponsesreasoningformat.md

@@ -3,10 +3,11 @@
 
 ## Values
 
-| Name                  | Value                 |
+| Name                        | Value                       |
-| --------------------- | --------------------- |
+| --------------------------- | --------------------------- |
-| `UNKNOWN`             | unknown               |
+| `UNKNOWN`                   | unknown                     |
-| `OPENAI_RESPONSES_V1` | openai-responses-v1   |
+| `OPENAI_RESPONSES_V1`       | openai-responses-v1         |
-| `XAI_RESPONSES_V1`    | xai-responses-v1      |
+| `AZURE_OPENAI_RESPONSES_V1` | azure-openai-responses-v1   |
-| `ANTHROPIC_CLAUDE_V1` | anthropic-claude-v1   |
+| `XAI_RESPONSES_V1`          | xai-responses-v1            |
-| `GOOGLE_GEMINI_V1`    | google-gemini-v1      |
+| `ANTHROPIC_CLAUDE_V1`       | anthropic-claude-v1         |
+| `GOOGLE_GEMINI_V1`          | google-gemini-v1            |

docs/components/openresponsesrequest.md

@@ -21,16 +21,19 @@ Request schema for Responses endpoint
 | `temperature`                                                                                                                                                                                                                                                                                        | *OptionalNullable[float]*                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `top_p`                                                                                                                                                                                                                                                                                              | *OptionalNullable[float]*                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `top_k`                                                                                                                                                                                                                                                                                              | *Optional[float]*                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
+| `image_config`                                                                                                                                                                                                                                                                                       | Dict[str, [components.OpenResponsesRequestImageConfig](../components/openresponsesrequestimageconfig.md)]                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | Provider-specific image configuration options. Keys and values vary by model/provider. See https://openrouter.ai/docs/features/multimodal/image-generation for more details.                                                                                                                         | {<br/>"aspect_ratio": "16:9"<br/>}                                                                                                                                                                                                                                                                   |
+| `modalities`                                                                                                                                                                                                                                                                                         | List[[components.ResponsesOutputModality](../components/responsesoutputmodality.md)]                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | Output modalities for the response. Supported values are "text" and "image".                                                                                                                                                                                                                         | [<br/>"text",<br/>"image"<br/>]                                                                                                                                                                                                                                                                      |
 | `prompt_cache_key`                                                                                                                                                                                                                                                                                   | *OptionalNullable[str]*                                                                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `previous_response_id`                                                                                                                                                                                                                                                                               | *OptionalNullable[str]*                                                                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `prompt`                                                                                                                                                                                                                                                                                             | [OptionalNullable[components.OpenAIResponsesPrompt]](../components/openairesponsesprompt.md)                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `include`                                                                                                                                                                                                                                                                                            | List[[components.OpenAIResponsesIncludable](../components/openairesponsesincludable.md)]                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `background`                                                                                                                                                                                                                                                                                         | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `safety_identifier`                                                                                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
-| `store`                                                                                                                                                                                                                                                                                              | *OptionalNullable[bool]*                                                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
+| `store`                                                                                                                                                                                                                                                                                              | *Optional[Literal[False]]*                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
-| `service_tier`                                                                                                                                                                                                                                                                                       | [OptionalNullable[components.ServiceTier]](../components/servicetier.md)                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  | auto                                                                                                                                                                                                                                                                                                 |
+| `service_tier`                                                                                                                                                                                                                                                                                       | [Optional[components.ServiceTier]](../components/servicetier.md)                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
 | `truncation`                                                                                                                                                                                                                                                                                         | [OptionalNullable[components.Truncation]](../components/truncation.md)                                                                                                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  | auto                                                                                                                                                                                                                                                                                                 |
 | `stream`                                                                                                                                                                                                                                                                                             | *Optional[bool]*                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | N/A                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                      |
-| `provider`                                                                                                                                                                                                                                                                                           | [OptionalNullable[components.Provider]](../components/provider.md)                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | When multiple model providers are available, optionally indicate your routing preference.                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                      |
+| `provider`                                                                                                                                                                                                                                                                                           | [OptionalNullable[components.OpenResponsesRequestProvider]](../components/openresponsesrequestprovider.md)                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | When multiple model providers are available, optionally indicate your routing preference.                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                      |
-| `plugins`                                                                                                                                                                                                                                                                                            | List[[components.Plugin](../components/plugin.md)]                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | Plugins you want to enable for this request, including their settings.                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                      |
+| `plugins`                                                                                                                                                                                                                                                                                            | List[[components.OpenResponsesRequestPluginUnion](../components/openresponsesrequestpluginunion.md)]                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | Plugins you want to enable for this request, including their settings.                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                      |
 | `user`                                                                                                                                                                                                                                                                                               | *Optional[str]*                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | A unique identifier representing your end-user, which helps distinguish between different users of your app. This allows your app to identify specific users in case of abuse reports, preventing your entire app from being affected by the actions of individual users. Maximum of 128 characters. |                                                                                                                                                                                                                                                                                                      |
+| `session_id`                                                                                                                                                                                                                                                                                         | *Optional[str]*                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                   | A unique identifier for grouping related requests (e.g., a conversation or agent workflow) for observability. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 128 characters.                                                          |                                                                                                                                                                                                                                                                                                      |

docs/components/openresponsesrequestengine.md

@@ -0,0 +1,9 @@
+# OpenResponsesRequestEngine
+
+
+## Values
+
+| Name     | Value    |
+| -------- | -------- |
+| `NATIVE` | native   |
+| `EXA`    | exa      |

docs/components/openresponsesrequestignore.md

@@ -0,0 +1,17 @@
+# OpenResponsesRequestIgnore
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/openresponsesrequestimageconfig.md

@@ -0,0 +1,17 @@
+# OpenResponsesRequestImageConfig
+
+
+## Supported Types
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+

docs/components/openresponsesrequestmaxprice.md

@@ -0,0 +1,14 @@
+# OpenResponsesRequestMaxPrice
+
+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:                              | A value in string format that is a large number | 1000                                            |
+| `completion`                                    | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `image`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `audio`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `request`                                       | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |

docs/components/openresponsesrequestonly.md

@@ -0,0 +1,17 @@
+# OpenResponsesRequestOnly
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/openresponsesrequestorder.md

@@ -0,0 +1,17 @@
+# OpenResponsesRequestOrder
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/openresponsesrequestpdf.md

@@ -0,0 +1,8 @@
+# OpenResponsesRequestPdf
+
+
+## Fields
+
+| Field                                                                                                | Type                                                                                                 | Required                                                                                             | Description                                                                                          |
+| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `engine`                                                                                             | [Optional[components.OpenResponsesRequestPdfEngine]](../components/openresponsesrequestpdfengine.md) | :heavy_minus_sign:                                                                                   | N/A                                                                                                  |

docs/components/openresponsesrequestpdfengine.md

@@ -0,0 +1,10 @@
+# OpenResponsesRequestPdfEngine
+
+
+## Values
+
+| Name          | Value         |
+| ------------- | ------------- |
+| `MISTRAL_OCR` | mistral-ocr   |
+| `PDF_TEXT`    | pdf-text      |
+| `NATIVE`      | native        |

docs/components/openresponsesrequestpluginautorouter.md

@@ -0,0 +1,10 @@
+# OpenResponsesRequestPluginAutoRouter
+
+
+## Fields
+
+| Field                                                                                                                                                                                                               | Type                                                                                                                                                                                                                | Required                                                                                                                                                                                                            | Description                                                                                                                                                                                                         | Example                                                                                                                                                                                                             |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`                                                                                                                                                                                                                | [components.IDAutoRouter](../components/idautorouter.md)                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                  | N/A                                                                                                                                                                                                                 |                                                                                                                                                                                                                     |
+| `enabled`                                                                                                                                                                                                           | *Optional[bool]*                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                  | Set to false to disable the auto-router plugin for this request. Defaults to true.                                                                                                                                  |                                                                                                                                                                                                                     |
+| `allowed_models`                                                                                                                                                                                                    | List[*str*]                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                  | List of model patterns to filter which models the auto-router can route between. Supports wildcards (e.g., "anthropic/*" matches all Anthropic models). When not specified, uses the default supported models list. | [<br/>"anthropic/*",<br/>"openai/gpt-4o",<br/>"google/*"<br/>]                                                                                                                                                      |

docs/components/openresponsesrequestpluginfileparser.md

@@ -0,0 +1,10 @@
+# OpenResponsesRequestPluginFileParser
+
+
+## Fields
+
+| Field                                                                              | Type                                                                               | Required                                                                           | Description                                                                        |
+| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `id`                                                                               | [components.IDFileParser](../components/idfileparser.md)                           | :heavy_check_mark:                                                                 | N/A                                                                                |
+| `enabled`                                                                          | *Optional[bool]*                                                                   | :heavy_minus_sign:                                                                 | Set to false to disable the file-parser plugin for this request. Defaults to true. |
+| `pdf`                                                                              | [Optional[components.PDFParserOptions]](../components/pdfparseroptions.md)         | :heavy_minus_sign:                                                                 | Options for PDF parsing.                                                           |

docs/components/openresponsesrequestpluginmoderation.md

@@ -1,4 +1,4 @@
-# PluginModeration
+# OpenResponsesRequestPluginModeration
 
 
 ## Fields

docs/components/openresponsesrequestpluginresponsehealing.md

@@ -0,0 +1,9 @@
+# OpenResponsesRequestPluginResponseHealing
+
+
+## Fields
+
+| Field                                                                                   | Type                                                                                    | Required                                                                                | Description                                                                             |
+| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| `id`                                                                                    | [components.IDResponseHealing](../components/idresponsehealing.md)                      | :heavy_check_mark:                                                                      | N/A                                                                                     |
+| `enabled`                                                                               | *Optional[bool]*                                                                        | :heavy_minus_sign:                                                                      | Set to false to disable the response-healing plugin for this request. Defaults to true. |

docs/components/openresponsesrequestpluginunion.md

@@ -0,0 +1,35 @@
+# OpenResponsesRequestPluginUnion
+
+
+## Supported Types
+
+### `components.OpenResponsesRequestPluginAutoRouter`
+
+```python
+value: components.OpenResponsesRequestPluginAutoRouter = /* values here */
+```
+
+### `components.OpenResponsesRequestPluginModeration`
+
+```python
+value: components.OpenResponsesRequestPluginModeration = /* values here */
+```
+
+### `components.OpenResponsesRequestPluginWeb`
+
+```python
+value: components.OpenResponsesRequestPluginWeb = /* values here */
+```
+
+### `components.OpenResponsesRequestPluginFileParser`
+
+```python
+value: components.OpenResponsesRequestPluginFileParser = /* values here */
+```
+
+### `components.OpenResponsesRequestPluginResponseHealing`
+
+```python
+value: components.OpenResponsesRequestPluginResponseHealing = /* values here */
+```
+

docs/components/openresponsesrequestpluginweb.md

@@ -0,0 +1,12 @@
+# OpenResponsesRequestPluginWeb
+
+
+## Fields
+
+| Field                                                                             | Type                                                                              | Required                                                                          | Description                                                                       |
+| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `id`                                                                              | [components.IDWeb](../components/idweb.md)                                        | :heavy_check_mark:                                                                | N/A                                                                               |
+| `enabled`                                                                         | *Optional[bool]*                                                                  | :heavy_minus_sign:                                                                | Set to false to disable the web-search plugin for this request. Defaults to true. |
+| `max_results`                                                                     | *Optional[float]*                                                                 | :heavy_minus_sign:                                                                | N/A                                                                               |
+| `search_prompt`                                                                   | *Optional[str]*                                                                   | :heavy_minus_sign:                                                                | N/A                                                                               |
+| `engine`                                                                          | [Optional[components.WebSearchEngine]](../components/websearchengine.md)          | :heavy_minus_sign:                                                                | The search engine to use for web search.                                          |

docs/components/openresponsesrequestprovider.md

@@ -0,0 +1,22 @@
+# OpenResponsesRequestProvider
+
+When multiple model providers are available, optionally indicate your routing preference.
+
+
+## Fields
+
+| 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.OpenResponsesRequestOrder](../components/openresponsesrequestorder.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.OpenResponsesRequestOnly](../components/openresponsesrequestonly.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.OpenResponsesRequestIgnore](../components/openresponsesrequestignore.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.OpenResponsesRequestSort]](../components/openresponsesrequestsort.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                                                                                                                                                                                                                                                                                                                                                     |
+| `max_price`                                                                                                                                                                                                                                                                                                                                               | [Optional[components.OpenResponsesRequestMaxPrice]](../components/openresponsesrequestmaxprice.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.                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                           |
+| `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                                                                                                                                                                                                                                                                                                                                                         |

docs/components/openresponsesrequestroute.md

@@ -0,0 +1,11 @@
+# OpenResponsesRequestRoute
+
+Routing strategy for multiple models: "fallback" (default) uses secondary models as backups, "sort" sorts all endpoints together by routing criteria.
+
+
+## Values
+
+| Name       | Value      |
+| ---------- | ---------- |
+| `FALLBACK` | fallback   |
+| `SORT`     | sort       |

docs/components/openresponsesrequestsort.md

@@ -0,0 +1,25 @@
+# OpenResponsesRequestSort
+
+The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is performed.
+
+
+## Supported Types
+
+### `components.ProviderSort`
+
+```python
+value: components.ProviderSort = /* values here */
+```
+
+### `components.ProviderSortConfig`
+
+```python
+value: components.ProviderSortConfig = /* values here */
+```
+
+### `Any`
+
+```python
+value: Any = /* values here */
+```
+

docs/components/parameter.md

@@ -26,5 +26,6 @@
 | `PARALLEL_TOOL_CALLS` | parallel_tool_calls   |
 | `INCLUDE_REASONING`   | include_reasoning     |
 | `REASONING`           | reasoning             |
+| `REASONING_EFFORT`    | reasoning_effort      |
 | `WEB_SEARCH_OPTIONS`  | web_search_options    |
 | `VERBOSITY`           | verbosity             |

docs/components/partition.md

@@ -0,0 +1,9 @@
+# Partition
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `MODEL` | model   |
+| `NONE`  | none    |

docs/components/pdfparserengine.md

@@ -0,0 +1,12 @@
+# PDFParserEngine
+
+The engine to use for parsing PDF files.
+
+
+## Values
+
+| Name          | Value         |
+| ------------- | ------------- |
+| `MISTRAL_OCR` | mistral-ocr   |
+| `PDF_TEXT`    | pdf-text      |
+| `NATIVE`      | native        |

docs/components/pdfparseroptions.md

@@ -0,0 +1,10 @@
+# PDFParserOptions
+
+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.                                 |

docs/components/percentilelatencycutoffs.md

@@ -0,0 +1,13 @@
+# PercentileLatencyCutoffs
+
+Percentile-based latency cutoffs. All specified cutoffs must be met for an endpoint to be preferred.
+
+
+## Fields
+
+| Field                         | Type                          | Required                      | Description                   |
+| ----------------------------- | ----------------------------- | ----------------------------- | ----------------------------- |
+| `p50`                         | *OptionalNullable[float]*     | :heavy_minus_sign:            | Maximum p50 latency (seconds) |
+| `p75`                         | *OptionalNullable[float]*     | :heavy_minus_sign:            | Maximum p75 latency (seconds) |
+| `p90`                         | *OptionalNullable[float]*     | :heavy_minus_sign:            | Maximum p90 latency (seconds) |
+| `p99`                         | *OptionalNullable[float]*     | :heavy_minus_sign:            | Maximum p99 latency (seconds) |

docs/components/percentilestats.md

@@ -0,0 +1,13 @@
+# PercentileStats
+
+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.
+
+
+## Fields
+
+| Field                    | Type                     | Required                 | Description              | Example                  |
+| ------------------------ | ------------------------ | ------------------------ | ------------------------ | ------------------------ |
+| `p50`                    | *float*                  | :heavy_check_mark:       | Median (50th percentile) | 25.5                     |
+| `p75`                    | *float*                  | :heavy_check_mark:       | 75th percentile          | 35.2                     |
+| `p90`                    | *float*                  | :heavy_check_mark:       | 90th percentile          | 48.7                     |
+| `p99`                    | *float*                  | :heavy_check_mark:       | 99th percentile          | 85.3                     |

docs/components/percentilethroughputcutoffs.md

@@ -0,0 +1,13 @@
+# PercentileThroughputCutoffs
+
+Percentile-based throughput cutoffs. All specified cutoffs must be met for an endpoint to be preferred.
+
+
+## Fields
+
+| Field                               | Type                                | Required                            | Description                         |
+| ----------------------------------- | ----------------------------------- | ----------------------------------- | ----------------------------------- |
+| `p50`                               | *OptionalNullable[float]*           | :heavy_minus_sign:                  | Minimum p50 throughput (tokens/sec) |
+| `p75`                               | *OptionalNullable[float]*           | :heavy_minus_sign:                  | Minimum p75 throughput (tokens/sec) |
+| `p90`                               | *OptionalNullable[float]*           | :heavy_minus_sign:                  | Minimum p90 throughput (tokens/sec) |
+| `p99`                               | *OptionalNullable[float]*           | :heavy_minus_sign:                  | Minimum p99 throughput (tokens/sec) |

docs/components/plugin.md

@@ -1,23 +0,0 @@
-# Plugin
-
-
-## Supported Types
-
-### `components.PluginModeration`
-
-```python
-value: components.PluginModeration = /* values here */
-```
-
-### `components.PluginWeb`
-
-```python
-value: components.PluginWeb = /* values here */
-```
-
-### `components.PluginFileParser`
-
-```python
-value: components.PluginFileParser = /* values here */
-```
-

docs/components/pluginfileparser.md

@@ -1,10 +0,0 @@
-# PluginFileParser
-
-
-## Fields
-
-| Field                                                    | Type                                                     | Required                                                 | Description                                              |
-| -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
-| `id`                                                     | [components.IDFileParser](../components/idfileparser.md) | :heavy_check_mark:                                       | N/A                                                      |
-| `max_files`                                              | *Optional[float]*                                        | :heavy_minus_sign:                                       | N/A                                                      |
-| `pdf`                                                    | [Optional[components.Pdf]](../components/pdf.md)         | :heavy_minus_sign:                                       | N/A                                                      |

docs/components/preferredmaxlatency.md

@@ -0,0 +1,25 @@
+# PreferredMaxLatency
+
+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.
+
+
+## Supported Types
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+
+### `components.PercentileLatencyCutoffs`
+
+```python
+value: components.PercentileLatencyCutoffs = /* values here */
+```
+
+### `Any`
+
+```python
+value: Any = /* values here */
+```
+

docs/components/preferredminthroughput.md

@@ -0,0 +1,25 @@
+# PreferredMinThroughput
+
+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.
+
+
+## Supported Types
+
+### `float`
+
+```python
+value: float = /* values here */
+```
+
+### `components.PercentileThroughputCutoffs`
+
+```python
+value: components.PercentileThroughputCutoffs = /* values here */
+```
+
+### `Any`
+
+```python
+value: Any = /* values here */
+```
+

docs/components/pricing.md

@@ -3,18 +3,18 @@
 
 ## Fields
 
-| Field                                                     | Type                                                      | Required                                                  | Description                                               |
+| Field                                           | Type                                            | Required                                        | Description                                     | Example                                         |
-| --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- |
+| ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- |
-| `prompt`                                                  | *Any*                                                     | :heavy_check_mark:                                        | A value in string or number format that is a large number |
+| `prompt`                                        | *str*                                           | :heavy_check_mark:                              | A value in string format that is a large number | 1000                                            |
-| `completion`                                              | *Any*                                                     | :heavy_check_mark:                                        | A value in string or number format that is a large number |
+| `completion`                                    | *str*                                           | :heavy_check_mark:                              | A value in string format that is a large number | 1000                                            |
-| `request`                                                 | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `request`                                       | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image_token`                                             | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image_token`                                   | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image_output`                                            | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image_output`                                  | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `audio`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `audio`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_audio_cache`                                       | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_audio_cache`                             | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `web_search`                                              | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `web_search`                                    | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `internal_reasoning`                                      | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `internal_reasoning`                            | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_cache_read`                                        | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_cache_read`                              | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_cache_write`                                       | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_cache_write`                             | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `discount`                                                | *Optional[float]*                                         | :heavy_minus_sign:                                        | N/A                                                       |
+| `discount`                                      | *Optional[float]*                               | :heavy_minus_sign:                              | N/A                                             |                                                 |

docs/components/prompttokensdetails.md

@@ -3,8 +3,9 @@
 
 ## Fields
 
-| Field              | Type               | Required           | Description        |
+| Field                | Type                 | Required             | Description          |
-| ------------------ | ------------------ | ------------------ | ------------------ |
+| -------------------- | -------------------- | -------------------- | -------------------- |
-| `cached_tokens`    | *Optional[float]*  | :heavy_minus_sign: | N/A                |
+| `cached_tokens`      | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |
-| `audio_tokens`     | *Optional[float]*  | :heavy_minus_sign: | N/A                |
+| `cache_write_tokens` | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |
-| `video_tokens`     | *Optional[float]*  | :heavy_minus_sign: | N/A                |
+| `audio_tokens`       | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |
+| `video_tokens`       | *Optional[float]*    | :heavy_minus_sign:   | N/A                  |

docs/components/providername.md

@@ -9,12 +9,14 @@
 | `AION_LABS`         | AionLabs            |
 | `ALIBABA`           | Alibaba             |
 | `AMAZON_BEDROCK`    | Amazon Bedrock      |
+| `AMAZON_NOVA`       | Amazon Nova         |
 | `ANTHROPIC`         | Anthropic           |
-| `ARCEE`             | Arcee               |
+| `ARCEE_AI`          | Arcee AI            |
 | `ATLAS_CLOUD`       | AtlasCloud          |
 | `AVIAN`             | Avian               |
 | `AZURE`             | Azure               |
 | `BASE_TEN`          | BaseTen             |
+| `BYTE_PLUS`         | BytePlus            |
 | `BLACK_FOREST_LABS` | Black Forest Labs   |
 | `CEREBRAS`          | Cerebras            |
 | `CHUTES`            | Chutes              |
@@ -34,10 +36,12 @@
 | `GROQ`              | Groq                |
 | `HYPERBOLIC`        | Hyperbolic          |
 | `INCEPTION`         | Inception           |
+| `INCEPTRON`         | Inceptron           |
 | `INFERENCE_NET`     | InferenceNet        |
 | `INFERMATIC`        | Infermatic          |
 | `INFLECTION`        | Inflection          |
 | `LIQUID`            | Liquid              |
+| `MARA`              | Mara                |
 | `MANCER_2`          | Mancer 2            |
 | `MINIMAX`           | Minimax             |
 | `MODEL_RUN`         | ModelRun            |
@@ -57,13 +61,17 @@
 | `PHALA`             | Phala               |
 | `RELACE`            | Relace              |
 | `SAMBA_NOVA`        | SambaNova           |
+| `SEED`              | Seed                |
 | `SILICON_FLOW`      | SiliconFlow         |
+| `SOURCEFUL`         | Sourceful           |
 | `STEALTH`           | Stealth             |
+| `STREAM_LAKE`       | StreamLake          |
 | `SWITCHPOINT`       | Switchpoint         |
-| `TARGON`            | Targon              |
 | `TOGETHER`          | Together            |
+| `UPSTAGE`           | Upstage             |
 | `VENICE`            | Venice              |
 | `WAND_B`            | WandB               |
+| `XIAOMI`            | Xiaomi              |
 | `X_AI`              | xAI                 |
 | `Z_AI`              | Z.AI                |
 | `FAKE_PROVIDER`     | FakeProvider        |

docs/components/providerpreferences.md

@@ -0,0 +1,22 @@
+# ProviderPreferences
+
+Provider routing preferences for the request.
+
+
+## Fields
+
+| 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                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                           |
+| `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.                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                           |
+| `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                                                                                                                                                                                                                                                                                                                                                         |

docs/components/providerpreferencesignore.md

@@ -0,0 +1,17 @@
+# ProviderPreferencesIgnore
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/providerpreferencesmaxprice.md

@@ -0,0 +1,14 @@
+# 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:                              | A value in string format that is a large number | 1000                                            |
+| `completion`                                    | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `image`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `audio`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
+| `request`                                       | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |

docs/components/providerpreferencesonly.md

@@ -0,0 +1,17 @@
+# ProviderPreferencesOnly
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/providerpreferencesorder.md

@@ -0,0 +1,17 @@
+# ProviderPreferencesOrder
+
+
+## Supported Types
+
+### `components.ProviderName`
+
+```python
+value: components.ProviderName = /* values here */
+```
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+

docs/components/providerpreferencespartition.md

@@ -0,0 +1,9 @@
+# ProviderPreferencesPartition
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `MODEL` | model   |
+| `NONE`  | none    |

docs/components/providerpreferencesprovidersort.md

@@ -0,0 +1,10 @@
+# ProviderPreferencesProviderSort
+
+
+## Values
+
+| Name         | Value        |
+| ------------ | ------------ |
+| `PRICE`      | price        |
+| `THROUGHPUT` | throughput   |
+| `LATENCY`    | latency      |

docs/components/providerpreferencesprovidersortconfig.md

@@ -0,0 +1,9 @@
+# ProviderPreferencesProviderSortConfig
+
+
+## Fields
+
+| Field                                                                                                      | Type                                                                                                       | Required                                                                                                   | Description                                                                                                | Example                                                                                                    |
+| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `by`                                                                                                       | [OptionalNullable[components.ProviderSort]](../components/providersort.md)                                 | :heavy_minus_sign:                                                                                         | N/A                                                                                                        | price                                                                                                      |
+| `partition`                                                                                                | [OptionalNullable[components.ProviderPreferencesPartition]](../components/providerpreferencespartition.md) | :heavy_minus_sign:                                                                                         | N/A                                                                                                        |                                                                                                            |

docs/components/providerpreferencessortunion.md

@@ -0,0 +1,25 @@
+# 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.ProviderSortConfigUnion`
+
+```python
+value: components.ProviderSortConfigUnion = /* values here */
+```
+
+### `components.SortEnum`
+
+```python
+value: components.SortEnum = /* values here */
+```
+

docs/components/providersort.md

@@ -1,7 +1,5 @@
 # ProviderSort
 
-The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is performed.
-
 
 ## Values
 

docs/components/providersortconfig.md

@@ -0,0 +1,9 @@
+# ProviderSortConfig
+
+
+## Fields
+
+| Field                                                                      | Type                                                                       | Required                                                                   | Description                                                                | Example                                                                    |
+| -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `by`                                                                       | [OptionalNullable[components.ProviderSort]](../components/providersort.md) | :heavy_minus_sign:                                                         | N/A                                                                        | price                                                                      |
+| `partition`                                                                | [OptionalNullable[components.Partition]](../components/partition.md)       | :heavy_minus_sign:                                                         | N/A                                                                        |                                                                            |

docs/components/providersortconfigenum.md

@@ -0,0 +1,10 @@
+# ProviderSortConfigEnum
+
+
+## Values
+
+| Name         | Value        |
+| ------------ | ------------ |
+| `PRICE`      | price        |
+| `THROUGHPUT` | throughput   |
+| `LATENCY`    | latency      |

docs/components/providersortconfigunion.md

@@ -0,0 +1,17 @@
+# ProviderSortConfigUnion
+
+
+## Supported Types
+
+### `components.ProviderPreferencesProviderSortConfig`
+
+```python
+value: components.ProviderPreferencesProviderSortConfig = /* values here */
+```
+
+### `components.ProviderSortConfigEnum`
+
+```python
+value: components.ProviderSortConfigEnum = /* values here */
+```
+

docs/components/providersortunion.md

@@ -0,0 +1,17 @@
+# ProviderSortUnion
+
+
+## Supported Types
+
+### `components.ProviderSort`
+
+```python
+value: components.ProviderSort = /* values here */
+```
+
+### `components.ProviderSortConfig`
+
+```python
+value: components.ProviderSortConfig = /* values here */
+```
+

docs/components/publicendpoint.md

@@ -5,18 +5,20 @@ Information about a specific model endpoint
 
 ## Fields
 
-| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    | Example                                                                                        |
+| Field                                                                                                                                                                                                     | Type                                                                                                                                                                                                      | Required                                                                                                                                                                                                  | Description                                                                                                                                                                                               | Example                                                                                                                                                                                                   |
-| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`                                                                                         | *str*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `name`                                                                                                                                                                                                    | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `model_name`                                                                                   | *str*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `model_name`                                                                                                                                                                                              | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `context_length`                                                                               | *float*                                                                                        | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `context_length`                                                                                                                                                                                          | *float*                                                                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `pricing`                                                                                      | [components.Pricing](../components/pricing.md)                                                 | :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                                                                                         |
+| `provider_name`                                                                                                                                                                                           | [components.ProviderName](../components/providername.md)                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | OpenAI                                                                                                                                                                                                    |
-| `tag`                                                                                          | *str*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `tag`                                                                                                                                                                                                     | *str*                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `quantization`                                                                                 | [Nullable[components.PublicEndpointQuantization]](../components/publicendpointquantization.md) | :heavy_check_mark:                                                                             | N/A                                                                                            | fp16                                                                                           |
+| `quantization`                                                                                                                                                                                            | [Nullable[components.PublicEndpointQuantization]](../components/publicendpointquantization.md)                                                                                                            | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | fp16                                                                                                                                                                                                      |
-| `max_completion_tokens`                                                                        | *Nullable[float]*                                                                              | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `max_completion_tokens`                                                                                                                                                                                   | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `max_prompt_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                                                                                            |                                                                                                |
+| `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                                                                                              |
+| `status`                                                                                                                                                                                                  | [Optional[components.EndpointStatus]](../components/endpointstatus.md)                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       | 0                                                                                                                                                                                                         |
-| `uptime_last_30m`                                                                              | *Nullable[float]*                                                                              | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |
+| `uptime_last_30m`                                                                                                                                                                                         | *Nullable[float]*                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                        | N/A                                                                                                                                                                                                       |                                                                                                                                                                                                           |
-| `supports_implicit_caching`                                                                    | *bool*                                                                                         | :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                                                                                                                                                                                                       |                                                                                                                                                                                                           |

docs/components/publicpricing.md

@@ -5,18 +5,18 @@ Pricing information for the model
 
 ## Fields
 
-| Field                                                     | Type                                                      | Required                                                  | Description                                               |
+| Field                                           | Type                                            | Required                                        | Description                                     | Example                                         |
-| --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- |
+| ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- |
-| `prompt`                                                  | *Any*                                                     | :heavy_check_mark:                                        | A value in string or number format that is a large number |
+| `prompt`                                        | *str*                                           | :heavy_check_mark:                              | A value in string format that is a large number | 1000                                            |
-| `completion`                                              | *Any*                                                     | :heavy_check_mark:                                        | A value in string or number format that is a large number |
+| `completion`                                    | *str*                                           | :heavy_check_mark:                              | A value in string format that is a large number | 1000                                            |
-| `request`                                                 | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `request`                                       | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image_token`                                             | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image_token`                                   | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `image_output`                                            | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `image_output`                                  | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `audio`                                                   | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `audio`                                         | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_audio_cache`                                       | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_audio_cache`                             | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `web_search`                                              | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `web_search`                                    | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `internal_reasoning`                                      | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `internal_reasoning`                            | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_cache_read`                                        | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_cache_read`                              | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `input_cache_write`                                       | *Optional[Any]*                                           | :heavy_minus_sign:                                        | A value in string or number format that is a large number |
+| `input_cache_write`                             | *Optional[str]*                                 | :heavy_minus_sign:                              | A value in string format that is a large number | 1000                                            |
-| `discount`                                                | *Optional[float]*                                         | :heavy_minus_sign:                                        | N/A                                                       |
+| `discount`                                      | *Optional[float]*                               | :heavy_minus_sign:                              | N/A                                             |                                                 |

docs/components/quantizations.md

@@ -0,0 +1,16 @@
+# Quantizations
+
+
+## Values
+
+| Name      | Value     |
+| --------- | --------- |
+| `INT4`    | int4      |
+| `INT8`    | int8      |
+| `FP4`     | fp4       |
+| `FP6`     | fp6       |
+| `FP8`     | fp8       |
+| `FP16`    | fp16      |
+| `BF16`    | bf16      |
+| `FP32`    | fp32      |
+| `UNKNOWN` | unknown   |

docs/components/responsesoutputitemreasoning.md

@@ -5,11 +5,13 @@ An output item containing reasoning
 
 ## Fields
 
-| Field                                                                                                                    | Type                                                                                                                     | Required                                                                                                                 | Description                                                                                                              |
+| Field                                                                                                                    | Type                                                                                                                     | Required                                                                                                                 | Description                                                                                                              | Example                                                                                                                  |
-| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `type`                                                                                                                   | [components.ResponsesOutputItemReasoningType](../components/responsesoutputitemreasoningtype.md)                         | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |
+| `type`                                                                                                                   | [components.ResponsesOutputItemReasoningType](../components/responsesoutputitemreasoningtype.md)                         | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
-| `id`                                                                                                                     | *str*                                                                                                                    | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |
+| `id`                                                                                                                     | *str*                                                                                                                    | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
-| `content`                                                                                                                | List[[components.ReasoningTextContent](../components/reasoningtextcontent.md)]                                           | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `content`                                                                                                                | List[[components.ReasoningTextContent](../components/reasoningtextcontent.md)]                                           | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
-| `summary`                                                                                                                | List[[components.ReasoningSummaryText](../components/reasoningsummarytext.md)]                                           | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |
+| `summary`                                                                                                                | List[[components.ReasoningSummaryText](../components/reasoningsummarytext.md)]                                           | :heavy_check_mark:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
-| `encrypted_content`                                                                                                      | *OptionalNullable[str]*                                                                                                  | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `encrypted_content`                                                                                                      | *OptionalNullable[str]*                                                                                                  | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
-| `status`                                                                                                                 | [Optional[components.ResponsesOutputItemReasoningStatusUnion]](../components/responsesoutputitemreasoningstatusunion.md) | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |
+| `status`                                                                                                                 | [Optional[components.ResponsesOutputItemReasoningStatusUnion]](../components/responsesoutputitemreasoningstatusunion.md) | :heavy_minus_sign:                                                                                                       | N/A                                                                                                                      |                                                                                                                          |
+| `signature`                                                                                                              | *OptionalNullable[str]*                                                                                                  | :heavy_minus_sign:                                                                                                       | A signature for the reasoning content, used for verification                                                             | EvcBCkgIChABGAIqQKkSDbRuVEQUk9qN1odC098l9SEj...                                                                          |
+| `format_`                                                                                                                | [OptionalNullable[components.ResponsesOutputItemReasoningFormat]](../components/responsesoutputitemreasoningformat.md)   | :heavy_minus_sign:                                                                                                       | The format of the reasoning content                                                                                      | anthropic-claude-v1                                                                                                      |

docs/components/responsesoutputitemreasoningformat.md

@@ -0,0 +1,15 @@
+# ResponsesOutputItemReasoningFormat
+
+The format of the reasoning content
+
+
+## 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            |

docs/components/responsesoutputmodality.md

@@ -0,0 +1,9 @@
+# ResponsesOutputModality
+
+
+## Values
+
+| Name    | Value   |
+| ------- | ------- |
+| `TEXT`  | text    |
+| `IMAGE` | image   |

docs/components/route.md

@@ -0,0 +1,9 @@
+# Route
+
+
+## Values
+
+| Name       | Value      |
+| ---------- | ---------- |
+| `FALLBACK` | fallback   |
+| `SORT`     | sort       |