Struct ChatClient 

pub struct ChatClient { /* private fields */ }

Blocking client for OpenAI-compatible /chat/completions.

Implementations

impl ChatClient

pub fn new( base_url: impl Into<String>, model: impl Into<String>, ) -> Result<Self, ChatError>

Builds a client targeting base_url with the default timeout.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub fn with_timeout( base_url: impl Into<String>, model: impl Into<String>, timeout: Duration, ) -> Result<Self, ChatError>

Builds a client with a custom timeout.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub fn with_max_tokens( base_url: impl Into<String>, model: impl Into<String>, max_tokens: Option<u32>, ) -> Result<Self, ChatError>

Builds a client with the default timeout and optional completion token cap.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub fn with_timeout_and_max_tokens( base_url: impl Into<String>, model: impl Into<String>, timeout: Duration, max_tokens: Option<u32>, ) -> Result<Self, ChatError>

Builds a client with a custom timeout and optional completion token cap.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub fn with_timeout_max_tokens_and_auth( base_url: impl Into<String>, model: impl Into<String>, timeout: Duration, max_tokens: Option<u32>, auth: ResolvedAuth, ) -> Result<Self, ChatError>

Builds a client with timeout, token cap, and resolved auth material.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub fn with_no_timeout_and_max_tokens( base_url: impl Into<String>, model: impl Into<String>, max_tokens: Option<u32>, ) -> Result<Self, ChatError>

Builds a client with no HTTP request timeout and optional completion token cap.

Errors

Returns ChatError::Build if the underlying reqwest::Client fails to build.

pub const fn with_reasoning_effort(self, effort: ReasoningEffort) -> Self

Sets OpenAI-compatible reasoning effort for the request body.

pub fn with_chat_template_kwargs(self, value: Value) -> Self

Sets provider-specific chat-template options.

pub fn model(&self) -> &str

Returns the configured model identifier.

pub fn base_url(&self) -> &str

Returns the configured chat-completions base URL.

pub fn complete( &self, messages: Vec<ChatMessage>, temperature: f32, ) -> Result<String, ChatError>

Sends a chat completion request and returns the first message content.

Errors

Returns ChatError::Http for transport failures or non-2xx statuses. Returns ChatError::MalformedResponse when the response body cannot be decoded or the first choice has no content.

pub fn complete_raw( &self, messages: Vec<ChatMessage>, temperature: f32, ) -> Result<ChatCompletionOutput, ChatError>

Sends a chat completion request and returns content plus raw response.

Errors

Returns ChatError::Http for transport failures or non-2xx statuses. Returns ChatError::MalformedResponse when the response body cannot be decoded or the first choice has no visible content.

Trait Implementations

impl Clone for ChatClient

fn clone(&self) -> ChatClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatClient

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

Formats the value using the given formatter.