Struct GeminiProvider 

pub struct GeminiProvider { /* private fields */ }

Available on crate feature gemini only.

Google Gemini LLM provider.

Implementations

impl GeminiProvider

pub const API_KEY_ENV: &'static str = "GEMINI_API_KEY"

The conventional environment variable holding the Gemini API key.

pub fn new( api_key: impl Into<String>, model: impl Into<String>, ) -> GeminiProvider

Create a new Gemini provider with the specified API key and model.

pub fn from_env() -> GeminiProvider

Create a provider using Gemini Flash, reading the API key from the conventional GEMINI_API_KEY environment variable.

Panics

Panics if GEMINI_API_KEY is not set. Prefer try_from_env outside of examples/tests.

pub fn try_from_env() -> Result<GeminiProvider, Error>

Create a provider using Gemini Flash, reading the API key from the conventional GEMINI_API_KEY environment variable.

Errors

Returns an error if GEMINI_API_KEY is unset or not valid UTF-8.

pub fn flash(api_key: impl Into<String>) -> GeminiProvider

Create a provider using Gemini 3 Flash Preview (fast and capable, current default).

pub fn flash_lite_31(api_key: String) -> GeminiProvider

Create a provider using Gemini 3.1 Flash Lite Preview.

pub fn flash_lite(api_key: String) -> GeminiProvider

Create a provider using Gemini 2.0 Flash Lite (fastest, most cost-effective).

pub fn pro_31(api_key: String) -> GeminiProvider

Create a provider using Gemini 3.1 Pro Preview.

pub fn pro(api_key: String) -> GeminiProvider

Create a provider using Gemini 3.1 Pro Preview (current recommended pro model).

pub const fn with_thinking(self, thinking: ThinkingConfig) -> GeminiProvider

Set the provider-owned thinking configuration for this model.

pub fn with_base_url(self, base_url: impl Into<String>) -> GeminiProvider

Override the base URL.

pub const fn with_header_auth(self) -> GeminiProvider

Send the API key via x-goog-api-key header instead of ?key= query parameter. Required when routing through proxies.

pub fn with_extra_headers( self, headers: Vec<(String, String)>, ) -> GeminiProvider

Add extra HTTP headers applied to every request.

Trait Implementations

impl Clone for GeminiProvider

fn clone(&self) -> GeminiProvider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl LlmProvider for GeminiProvider

fn chat<'life0, 'async_trait>( &'life0 self, request: ChatRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatOutcome, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, GeminiProvider: 'async_trait,

Non-streaming chat completion.

fn chat_stream( &self, request: ChatRequest, ) -> Pin<Box<dyn Stream<Item = Result<StreamDelta, Error>> + Send + '_>>

Streaming chat completion.

fn model(&self) -> &str

fn provider(&self) -> &'static str

fn configured_thinking(&self) -> Option<&ThinkingConfig>

Provider-owned thinking configuration, if any.

fn capabilities(&self) -> Option<&'static ModelCapabilities>

Canonical capability metadata for this provider/model, if known.

fn validate_thinking_config( &self, thinking: Option<&ThinkingConfig>, ) -> Result<(), Error>

Validate a thinking configuration against the provider/model capabilities.

fn resolve_thinking_config( &self, request_thinking: Option<&ThinkingConfig>, ) -> Result<Option<ThinkingConfig>, Error>

Resolve the effective thinking configuration for a request.

fn default_max_tokens(&self) -> u32

Default maximum output tokens for this provider/model when the caller does not explicitly override AgentConfig.max_tokens.

fn structured_output_support(&self) -> StructuredOutputSupport

How this provider satisfies a structured-output (ResponseFormat) request.