Struct ModelsDevClient 

pub struct ModelsDevClient { /* private fields */ }

Smart HTTP client for the models.dev API with intelligent caching.

This client provides HTTP communication with automatic caching that only updates when the API data has actually changed, using conditional requests.

Implementations

impl ModelsDevClient

pub fn new() -> Self

Create a new ModelsDevClient with default settings.

Uses the default API base URL and 30-second timeout.

pub fn with_base_url(api_base_url: impl Into<String>) -> Self

Create a new ModelsDevClient with a custom API base URL.

Arguments

• api_base_url - The base URL for the models.dev API

Examples

use models_dev::ModelsDevClient;
let client = ModelsDevClient::with_base_url("https://custom.api.models.dev");

pub async fn fetch_providers(&self) -> Result<ModelsDevResponse, ModelsDevError>

Fetch providers with smart caching - only updates if API changed.

This method uses conditional HTTP requests to check if the API data has changed before fetching the full response. It combines disk caching with conditional requests for optimal performance.

Returns

• Ok(ModelsDevResponse) - The API response containing providers
• Err(ModelsDevError) - If the request fails or the response is invalid

Examples

use models_dev::ModelsDevClient;
let client = ModelsDevClient::new();
let response = client.fetch_providers().await?;
println!("Found {} providers", response.providers.len());

pub fn api_base_url(&self) -> &str

Get the API base URL.

Returns

The base URL used for API requests

pub fn timeout(&self) -> Duration

Get the request timeout.

Returns

The timeout duration for HTTP requests

pub fn clear_cache(&self) -> Result<(), ModelsDevError>

Clear cache metadata.

Clears the cache metadata, forcing a fresh API request on next call.

Examples

use models_dev::ModelsDevClient;
let client = ModelsDevClient::new();
client.clear_cache().unwrap();

pub fn cache_info(&self) -> CacheInfo

Get cache information for debugging.

Returns information about the current cache state.

Trait Implementations

impl Clone for ModelsDevClient

fn clone(&self) -> ModelsDevClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelsDevClient

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

Formats the value using the given formatter.

impl Default for ModelsDevClient

fn default() -> Self

Returns the “default value” for a type.