Struct ClientConfig 

pub struct ClientConfig {
    pub api_key: SecretString,
    pub base_url: Option<String>,
    pub timeout: Duration,
    pub max_retries: u32,
    pub credential_provider: Option<Arc<dyn CredentialProvider>>,
    pub load_env: bool,
    /* private fields */
}

Configuration for an LLM client.

api_key is stored as a SecretString so it is zeroed on drop and never printed accidentally. Access it via secrecy::ExposeSecret.

Fields

api_key: SecretString

API key for authentication (stored as a secret).

base_url: Option<String>

Override base URL. When set, all requests go here regardless of model name, and provider auto-detection is skipped.

timeout: Duration

Request timeout.

max_retries: u32

Maximum number of retries on 429 / 5xx responses.

credential_provider: Option<Arc<dyn CredentialProvider>>

Optional dynamic credential provider for token-based auth (Azure AD, Vertex OAuth2) or refreshable credentials (AWS STS).

When set, the client calls resolve() before each request to obtain a fresh credential. When None, the static api_key is used.

load_env: bool

Automatically load the API key from the provider’s environment variable when no explicit key is provided.

When true (the default) and api_key is empty, [DefaultClient::new] reads the provider’s designated environment variable (e.g. OPENAI_API_KEY for OpenAI). Set to false to suppress this behaviour and require the caller to supply the key explicitly.

Has no effect on WASM targets, where std::env::var is unavailable.

Implementations

impl ClientConfig

pub fn new(api_key: impl Into<String>) -> Self

Create a config with the given API key and sensible defaults.

pub fn headers(&self) -> &[(String, String)]

Return the extra headers as an ordered slice of (name, value) pairs.

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

Note: intentionally does not implement Debug so the secret key is never accidentally logged via {:?}.

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

Formats the value using the given formatter.