Struct Model 

pub struct Model {
    pub id: String,
    pub name: Option<String>,
    pub description: Option<String>,
    pub type: Option<String>,
    pub created_at: Option<u64>,
    pub owned_by: Option<String>,
    pub context_length: Option<u32>,
}

Represents a single model available from a provider.

This struct is designed to be flexible enough to accommodate the varying responses from different LLM providers while providing a common interface.

Fields

• id: The unique identifier for the model (required)
• name: A human-readable name for the model
• description: A detailed description of the model’s capabilities
• r#type: The type of model (e.g., “chat”, “completion”, “embedding”)
• created_at: Timestamp when the model was created
• owned_by: The organization or entity that owns the model
• context_length: The maximum context window size for the model

Example

use rig::model::Model;

// Create a model with just an ID
let model = Model::from_id("gpt-4");

// Create a model with ID and name
let model = Model::new("gpt-4", "GPT-4");

// Create a model with all fields
let model = Model {
    id: "gpt-4".to_string(),
    name: Some("GPT-4".to_string()),
    description: Some("A large language model...".to_string()),
    r#type: Some("chat".to_string()),
    created_at: Some(1677610600),
    owned_by: Some("openai".to_string()),
    context_length: Some(8192),
};

Fields

id: String

The unique identifier for the model (required)

name: Option<String>

A human-readable name for the model

description: Option<String>

A detailed description of the model’s capabilities

type: Option<String>

The type of model (e.g., “chat”, “completion”, “embedding”)

created_at: Option<u64>

Timestamp when the model was created (Unix epoch)

owned_by: Option<String>

The organization or entity that owns the model

context_length: Option<u32>

The maximum context window size for the model

Implementations

impl Model

pub fn new(id: impl Into<String>, name: impl Into<String>) -> Self

Creates a new Model with the given ID and name.

Arguments

• id - The unique identifier for the model
• name - A human-readable name for the model

Example

use rig::model::Model;

let model = Model::new("gpt-4", "GPT-4");
assert_eq!(model.id, "gpt-4");
assert_eq!(model.name, Some("GPT-4".to_string()));

pub fn from_id(id: impl Into<String>) -> Self

Creates a new Model with only the required ID field.

Arguments

• id - The unique identifier for the model

Example

use rig::model::Model;

let model = Model::from_id("gpt-4");
assert_eq!(model.id, "gpt-4");
assert_eq!(model.name, None);

pub fn display_name(&self) -> &str

Returns a reference to the model’s name, or the ID if no name is set.

This is useful for display purposes when you want to show the most human-readable identifier available.

Example

use rig::model::Model;

let model_with_name = Model::new("gpt-4", "GPT-4");
assert_eq!(model_with_name.display_name(), "GPT-4");

let model_without_name = Model::from_id("gpt-4");
assert_eq!(model_without_name.display_name(), "gpt-4");

Trait Implementations

impl Clone for Model

fn clone(&self) -> Model

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Model

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Model

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Model

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

Formats the value using the given formatter.

impl PartialEq for Model

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Model

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Model

impl StructuralPartialEq for Model