Struct ChatGptClient 

pub struct ChatGptClient { /* private fields */ }

OpenAI API client.

Implementations

impl ChatGptClient

pub fn new(api_key: &str, model: &str) -> Result<Self>

Create a new client. The API key is baked into the underlying reqwest::Client as a default header so it doesn’t need to be cloned per-request.

pub fn with_max_output_tokens(self, n: u32) -> Self

Override the maximum number of output tokens per response.

pub fn with_reasoning_effort(self, effort: &str) -> Self

Override the default reasoning effort level.

Valid values: "minimal", "low", "medium", "high".

pub fn model(&self) -> &str

Returns the model name this client is configured for.

pub async fn create_response( &self, input: &[Value], instructions: Option<&str>, tools: Option<&[ToolDefinition]>, previous_response_id: Option<&str>, ) -> Result<ApiResponse, LlmError>

Send a blocking request to the Responses API.

Returns the full parsed response including output items and usage. The agent loop inspects function_calls() to decide whether to execute tools or return the final answer.

pub fn create_response_stream( &self, input: &[Value], instructions: Option<&str>, tools: Option<&[ToolDefinition]>, previous_response_id: Option<&str>, ) -> impl Stream<Item = Result<ResponseStreamEvent, LlmError>> + Send

Stream a response from the Responses API, yielding structured events.

Returns a stream of ResponseStreamEvents: text deltas, function calls, and a final ResponseCompleted with the response ID (for chaining) and token usage.

The returned stream is 'static – it clones the HTTP client and model name so callers don’t need to worry about lifetimes.

Trait Implementations

impl Clone for ChatGptClient

fn clone(&self) -> ChatGptClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.