Enum ModelSpec 

pub enum ModelSpec {
    Name(ModelName),
    Iden(ModelIden),
    Target(ServiceTarget),
}

Specifies how to identify and resolve a model for API calls.

ModelSpec provides three levels of control over model resolution:

• ModelSpec::Name: Just a model name string. The adapter kind is inferred from the name, and auth/endpoint are resolved via the client’s configured resolvers.

• ModelSpec::Iden: An explicit ModelIden with adapter kind specified. Skips adapter inference but still resolves auth/endpoint via config.

• ModelSpec::Target: A complete ServiceTarget with endpoint, auth, and model. Used directly, only runs the service target resolver.

Examples

use genai::adapter::AdapterKind;
use genai::resolver::{AuthData, Endpoint};
use genai::{ModelIden, ModelSpec, ServiceTarget};

// Using a string name (full inference)
let spec: ModelSpec = "gpt-4".into();

// Using an explicit ModelIden (skip adapter inference)
let spec: ModelSpec = ModelIden::new(AdapterKind::OpenAI, "gpt-4").into();

// Using a complete ServiceTarget (bypass all resolution)
let target = ServiceTarget {
    endpoint: Endpoint::from_static("https://custom.api/v1/"),
    auth: AuthData::from_env("CUSTOM_API_KEY"),
    model: ModelIden::new(AdapterKind::OpenAI, "custom-model"),
};
let spec: ModelSpec = target.into();

Variants

Name(ModelName)

Model name - without or without model namespace

Iden(ModelIden)

Explicit ModelIden - skips adapter inference, still resolves auth/endpoint.

Target(ServiceTarget)

Complete ServiceTarget - used directly, bypasses model mapping and auth resolution

Implementations

impl ModelSpec

pub fn from_name(name: impl Into<ModelName>) -> Self

Creates a ModelSpec::Name from a string.

pub fn from_static_name(name: &'static str) -> Self

Creates a ModelSpec::Name from a static str.

pub fn from_iden(model_iden: impl Into<ModelIden>) -> Self

Creates a ModelSpec::Iden from a ModelIden

pub fn from_target(target: ServiceTarget) -> Self

Creates a ModelSpec::Target from a complete service target.

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 From<&&str> for ModelSpec

fn from(name: &&str) -> Self

Converts to this type from the input type.

impl From<&ModelIden> for ModelSpec

fn from(model: &ModelIden) -> Self

Converts to this type from the input type.

impl From<&ModelName> for ModelSpec

fn from(model: &ModelName) -> Self

Converts to this type from the input type.

impl From<&String> for ModelSpec

fn from(name: &String) -> Self

Converts to this type from the input type.

impl From<&str> for ModelSpec

fn from(name: &str) -> Self

Converts to this type from the input type.

impl From<ModelIden> for ModelSpec

fn from(model: ModelIden) -> Self

Converts to this type from the input type.

impl From<ModelName> for ModelSpec

fn from(model: ModelName) -> Self

Converts to this type from the input type.

impl From<ServiceTarget> for ModelSpec

fn from(target: ServiceTarget) -> Self

Converts to this type from the input type.

impl From<String> for ModelSpec

fn from(name: String) -> Self

Converts to this type from the input type.