Struct Client

pub struct Client { /* private fields */ }

A thread-safe client for interacting with Google’s Generative Language API.

Features

• Manages authentication tokens and TLS configuration
• Provides access to generative AI operations
• Implements content caching functionality
• Supports automatic pagination of list operations

Example

use google_ai_rs::{Client, Auth};

let auth = Auth::new("your-api-key");
let client = Client::new(auth).await?;

Implementations

impl Client

pub async fn new(auth: Auth) -> Result<Self, Error>

Constructs a new client with authentication and optional configuration.

Arguments

• auth - API authentication credentials

Errors

Returns Error::Setup for configuration issues or Error::Net for connection failures.

pub fn builder() -> ClientBuilder

Create a builder for configuring client options

pub async fn update_auth(&self, new_auth: Auth)

Updates authentication credentials atomically

Subsequent requests will use the new credentials immediately. This operation is thread-safe.

pub async fn create_cached_content( &self, content: CachedContent, ) -> Result<CachedContent, Error>

Creates a new cached content entry

Arguments

• content - Content to cache without name (server-generated)

Errors

Returns Error::InvalidArgument if content contains a name

pub async fn get_cached_content( &self, name: &str, ) -> Result<CachedContent, Error>

Retrieves the CachedContent with the given name.

pub async fn delete_cached_content(&self, name: &str) -> Result<(), Error>

Deletes the CachedContent with the given name.

pub async fn update_cached_content( &self, cc: &CachedContent, ) -> Result<CachedContent, Error>

Modifies the CachedContent.

It returns the modified CachedContent.

The argument CachedContent must have its name field and fields to update populated.

pub fn list_cached_contents(&self) -> CachedContentIterator<'_>

Returns an async iterator over cached content entries

Automatically handles pagination through server-side results.

pub async fn get_model(&self, name: &str) -> Result<Model, Error>

Gets information about a specific Model such as its version number, token limits, etc

pub async fn get_tuned_model( &self, resource_name: &str, ) -> Result<TunedModel, Error>

Gets information about a specific TunedModel.

pub async fn list_models(&self) -> ModelsListIterator<'_>

Returns an async iterator over models list results

Automatically handles pagination through server-side results.

pub async fn list_tuned_models(&self) -> TunedModelsListIterator<'_>

Returns an async iterator over tuned models list results

Automatically handles pagination through server-side results.

pub async fn update_tuned_model( &self, m: &TunedModel, ) -> Result<TunedModel, Error>

Updates a tuned model.

pub async fn delete_tuned_model(&self, name: &str) -> Result<(), Error>

Deletes the TunedModel with the given name.

impl Client

pub fn embedding_model<'c>(&'c self, name: &str) -> Model<'c>

Creates a new embedding model interface

Shorthand for EmbeddingModel::new()

impl Client

pub fn generative_model<'c>(&'c self, name: &str) -> GenerativeModel<'c>

Creates a new generative model interface

Shorthand for GenerativeModel::new()

pub fn typed_model<'c, T: AsSchema>(&'c self, name: &str) -> TypedModel<'c, T>

Creates a new typed generative model interface

Shorthand for TypedModel::new()

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.