ModelReasoning Type | OpenRouter TypeScript SDK | OpenRouter

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Reasoning effort configuration. Omitted for non-reasoning models and dynamic router models.

Example Usage

1 import { ModelReasoning } from "@openrouter/sdk/models";
2 
3 let value: ModelReasoning = {
4   mandatory: false,
5 };

Field	Type	Required	Description	Example
`defaultEffort`	models.DefaultEffort	➖	N/A	medium
`defaultEnabled`	boolean	➖	Default reasoning enabled state when the client does not set `reasoning.enabled`.
`mandatory`	boolean	✔️	When true, reasoning cannot be disabled and effort “none” is rejected.
`supportedEfforts`	models.ReasoningEffort[]	➖	Allowed reasoning effort values for this model, in descending effort order (highest first). Null means no allowlist — all gateway effort values are accepted.
`supportsMaxTokens`	boolean	➖	Present and `true` when the model accepts `reasoning.max_tokens` in requests (Anthropic-style) instead of or in addition to `reasoning.effort`. Omitted otherwise.