Struct Gemini 

pub struct Gemini { /* private fields */ }

Calls the Gemini Developer API.

The key is held here and never journaled — transport metadata in exactly the sense a peer credential is, and the same rule applies: a secret in a hash-chained record cannot be redacted afterwards, only discovered.

Implementations

impl Gemini

pub const DEFAULT_TIMEOUT: Duration

pub const DEFAULT_BASE: &'static str = "https://generativelanguage.googleapis.com"

The default endpoint.

pub const VERSION: &'static str = "v1beta"

The API version this driver speaks.

Pinned rather than tracking the newest, for the reason every version here is pinned: a provider that changes its response shape under a running plane changes what replay reads back.

pub fn new(key: impl Into<String>) -> Result<Self, ModelError>

Build with a key.

Errors

If the HTTP client cannot be built.

pub fn from_env() -> Result<Self, ModelError>

Take the key from GEMINI_API_KEY, falling back to GOOGLE_API_KEY.

Both are read because both are in wide use and a deployment that exported the other one would otherwise get an authentication failure naming neither.

Errors

If neither variable is set, or the HTTP client cannot be built.

pub fn base(self, base: impl Into<String>) -> Self

Point at another endpoint — a regional host, or a test double.

pub const fn timeout(self, timeout: Duration) -> Self

Bound connection, generation, and response streaming as one operation.

pub fn structured_via(self, mode: SchemaMode) -> Self

How to obtain a schema-conforming answer from every model.

pub fn structured_via_for( self, model: impl Into<String>, mode: SchemaMode, ) -> Self

How to obtain a schema-conforming answer from one model.

pub fn safety(self, safety: SafetySettings) -> Self

Apply the deployment’s own safety thresholds to every call.

See SafetySettings for the posture. In short: this crate ships no classifier, Google’s is configured here, and what the runtime owns is that the choice is effect identity and that an intervention is a metered refusal rather than an answer.

pub fn egress(self, egress: Egress) -> Self

Restrict where this driver may connect.

Deny-by-default once set — see Egress.

pub const fn buffered(self) -> Self

Ask for the whole response at once instead of streaming it.

Streaming is the default for the reason it is elsewhere in this crate: Gemini reports usageMetadata in the stream, so a severed connection can say what it burned rather than being billed as zero and retried for free.

Trait Implementations

impl Debug for Gemini

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

Redacts the key. Deriving Debug would print it into every log line and span that touches the provider.

impl ModelProvider for Gemini

fn request_profile(&self, model: &ModelId) -> Value

Stable, non-secret configuration that changes the provider wire request.

fn complete<'life0, 'life1, 'async_trait>( &'life0 self, request: Request<'life1>, ) -> Pin<Box<dyn Future<Output = Result<Completion, ModelError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Complete a prompt.