Enum Reasoning 

pub enum Reasoning {
    Off,
    Effort(ReasoningEffort),
    Budget(u32),
}

What to ask a reasoning-capable model to do with its thinking.

This is a request, not a capability: Some(_) says what the caller wants and None says nothing at all, leaving the model’s own default alone. Whether the endpoint can carry it is the provider’s business — a provider that cannot say this on the wire drops it rather than making every caller ask first.

Where the model does honour it, its thinking comes back on a separate channel (LlmResponse::reasoning / LlmStreamEvent::Reasoning).

Variants

Off

Don’t think — for models that let reasoning be turned off. The one setting a small, fast model usually wants, and the one an effort-only knob cannot express.

Effort(ReasoningEffort)

Think at one of the provider’s named effort levels.

Budget(u32)

Think within a hard budget of reasoning tokens.

Trait Implementations

impl Clone for Reasoning

fn clone(&self) -> Reasoning

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Reasoning

impl Debug for Reasoning

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Reasoning

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Accepts a level ("high") or a token budget (2000) — one parser for every host, so a bad value is refused the same way with the same message wherever it was written.

impl Display for Reasoning

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Reasoning

impl FromStr for Reasoning

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses the tokens a host config or OPENROUTER_REASONING accepts: off, low, medium, high, or a plain token budget (2000).

type Err = String

The associated error which can be returned from parsing.

impl PartialEq for Reasoning

fn eq(&self, other: &Reasoning) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Reasoning

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Reasoning