Struct OpenRouterConfig 

pub struct OpenRouterConfig {
    pub provider_sort: Option<String>,
    pub zdr: Option<bool>,
    pub allow_fallbacks: Option<bool>,
    pub ignore: Vec<String>,
    pub only: Vec<String>,
    pub exclude_reasoning: Option<bool>,
    pub web_search: Option<WebSearchConfig>,
}

OpenRouter provider routing extensions. Docs: https://openrouter.ai/docs/guides/routing/provider-selection

Maps to the "provider" object in the request body. Fields are all optional — only set the ones you want to override. Empty struct = no provider block emitted.

Fields

provider_sort: Option<String>

Provider prioritization: "throughput" | "latency" | "price". Defaults to OpenRouter’s price-first routing when unset.

zdr: Option<bool>

When true, restricts routing to Zero Data Retention endpoints. Compliance requirement for sensitive workloads.

allow_fallbacks: Option<bool>

When false, disables automatic fallback to backup providers on primary failure. Use when you want deterministic routing and prefer a hard fail over a silent reroute to a slower endpoint.

ignore: Vec<String>

Provider slugs to exclude from routing (case-insensitive OpenRouter slug, e.g. ["nextbit", "ionstream"]). Useful when pairing allow_fallbacks: false with provider_sort: "throughput" — otherwise the fastest slot is often held by a high-throughput but low-uptime provider. Injected as "provider.ignore": [...].

only: Vec<String>

Provider allowlist — restrict routing to ONLY these provider slugs (e.g. ["akashml/fp8", "parasail/fp8"]). Mutually exclusive in spirit with ignore; setting both means “allowlist minus the ignore set”. Use to pin a model to a specific provider variant when the default routing yields a smaller advertised context window than the targeted variant — e.g. qwen/qwen3.6-35b-a3b defaults to a 131k window but the akashml/fp8 and parasail/fp8 variants advertise 262k. Injected as "provider.only": [...].

exclude_reasoning: Option<bool>

When true, strip reasoning tokens from the visible content stream (maps to OpenRouter’s reasoning.exclude: true). The model still reasons internally at the configured reasoning_effort; only the chain-of-thought portion of the output is omitted. Use for models that otherwise dump reasoning into content and leave zero budget for the final structured-output tool call (observed: gpt-oss-120b via OR native streaming). When this flag switches the request to the unified reasoning: { effort, exclude } object, the legacy reasoning_effort top-level field is no longer emitted.

web_search: Option<WebSearchConfig>

When set, enables OpenRouter’s web-search plugin for this agent — injected into the request plugins array. Omitted → plugins: [] (the explicit no-outbound-network default). See WebSearchConfig.

Trait Implementations

impl Clone for OpenRouterConfig

fn clone(&self) -> OpenRouterConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for OpenRouterConfig

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for OpenRouterConfig

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

Formats the value using the given formatter.

impl Default for OpenRouterConfig

fn default() -> OpenRouterConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OpenRouterConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OpenRouterConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for OpenRouterConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OpenRouterConfig

impl ToSchema for OpenRouterConfig

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.