Struct ModelSpec 

#[non_exhaustive]
pub struct ModelSpec {

    pub id: String,
    pub provider: ProviderId,
    pub display_name: String,
    pub context_window: Option<u32>,
    pub max_output_tokens: Option<u32>,
    pub input: Modalities,
    pub reasoning: ReasoningSupport,
    pub caching: CacheSupport,
    pub tools: bool,
    pub structured_output: bool,
    pub pricing: Option<Pricing>,
    pub deprecated: bool,
    pub sampling: Option<Sampling>,
    /* private fields */
}

One model’s facts: limits, input modalities, the reasoning and caching it takes, and its prices. Built by Catalog from its data.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: String

The provider’s own model id.

provider: ProviderId

The provider serving the model under Self::id.

display_name: String

A human-readable name.

context_window: Option<u32>

The most tokens the model reads and writes in one request, if known.

max_output_tokens: Option<u32>

The most tokens the model writes in one reply, if known.

input: Modalities

What the model reads.

reasoning: ReasoningSupport

The reasoning the model takes.

caching: CacheSupport

The cache retentions the model honours.

tools: bool

Whether the model calls tools.

structured_output: bool

Whether the model constrains its output to a JSON schema.

pricing: Option<Pricing>

Prices in USD per million tokens, if known.

deprecated: bool

Whether the provider has deprecated the model.

sampling: Option<Sampling>

When the model takes sampling parameters (temperature, top_p, top_logprobs, logprobs), or None when unknown.

Implementations

impl ModelSpec

pub fn validate( &self, options: &GenerationOptions, ) -> Result<(), UnsupportedOption>

Checks options against what the model takes: reasoning against Self::reasoning and cache against Self::caching. The error names the option, the provider’s vendor and this model. A reasoning row with no reasoning options refuses every reasoning value (see ReasoningSupport).

Trait Implementations

impl Clone for ModelSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelSpec

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

Formats the value using the given formatter.

impl<'a> From<&'a ModelSpec> for ModelSelector<'a>

fn from(spec: &'a ModelSpec) -> Self

Converts to this type from the input type.

impl PartialEq for ModelSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ModelSpec