Enum GeminiError 

pub enum GeminiError {
    Network(Error),
    RequestSerialization(Error),
    ResponseParsing {
        context: String,
        source: Error,
    },
    ApiError {
        status: StatusCode,
        detail: Option<GeminiErrorDetail>,
        body_text: String,
    },
    InvalidConfiguration(String),
    InvalidInput(String),
    UnexpectedResponse(String),
    Streaming(String),
    BatchTooLarge {
        limit: Option<usize>,
        actual: usize,
    },
}

Internal error type consolidating all possible failures within the Gemini client. This type is intended to be converted into the public ChatError or EmbeddingError at the trait implementation boundaries.

Variants

Network(Error)

Error during network communication (sending request, reading response).

RequestSerialization(Error)

Error serializing the request body to JSON.

ResponseParsing

Error parsing a successful response body from the API.

Fields

context: String

source: Error

ApiError

Error reported by the Gemini API (received non-success status code).

Fields

status: StatusCode

HTTP status code received from the API.

detail: Option<GeminiErrorDetail>

Parsed error details from the response body, if available.

body_text: String

Raw response body text.

InvalidConfiguration(String)

Invalid configuration provided to the client.

InvalidInput(String)

Invalid input provided to an API method (e.g., empty text list, batch size exceeded). This is for validation before sending the request or based on API feedback clearly indicating bad input (like specific 400 errors).

UnexpectedResponse(String)

The API returned an unexpected response format or data inconsistency. (e.g., embedding count mismatch, missing expected fields in success response).

Streaming(String)

Error specific to streaming operations (placeholder for future implementation).

BatchTooLarge

The number of input chunks exceeds the batch size limit.

Fields

limit: Option<usize>

The maximum allowed batch size, if known.

actual: usize

The actual batch size provided.

Trait Implementations

impl Debug for GeminiError

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

Formats the value using the given formatter.

impl Display for GeminiError

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

Formats the value using the given formatter.

impl Error for GeminiError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for GeminiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GeminiError> for ChatError

fn from(err: GeminiError) -> Self

Converts to this type from the input type.

impl From<GeminiError> for EmbeddingError

fn from(err: GeminiError) -> Self

Converts to this type from the input type.