Enum Error 

#[non_exhaustive]
pub enum Error {
    Validation(Box<ErrorDetails>),
    AccessDenied(Box<ErrorDetails>),
    ServiceQuotaExceeded(Box<ErrorDetails>),
    ResourceNotFound(Box<ErrorDetails>),
    Throttling(Box<ErrorDetails>),
    ModelTimeout(Box<ErrorDetails>),
    ModelError(Box<ErrorDetails>),
    ModelStreamError(Box<ErrorDetails>),
    ServiceUnavailable(Box<ErrorDetails>),
    InternalServer(Box<ErrorDetails>),
    MissingApiKey,
    Sdk {
        message: String,
        retryable: bool,
    },
}

The SDK error type — all variants mirror the spec §4 exception taxonomy.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Validation(Box<ErrorDetails>)

400 / invalid_request_error / VALIDATION_ERROR

AccessDenied(Box<ErrorDetails>)

401/403 / authentication_error / AUTHORIZATION_ERROR / MODEL_NOT_ALLOWED

ServiceQuotaExceeded(Box<ErrorDetails>)

402 / usage_cap_exceeded / BUDGET_EXCEEDED

ResourceNotFound(Box<ErrorDetails>)

404 / MODEL_NOT_FOUND

Throttling(Box<ErrorDetails>)

429 (retryable) / rate_limit_exceeded / RATE_LIMIT_EXCEEDED

ModelTimeout(Box<ErrorDetails>)

408 / TIMEOUT_ERROR

ModelError(Box<ErrorDetails>)

5xx model-side error

ModelStreamError(Box<ErrorDetails>)

Stream-specific error (subtype of ModelError)

ServiceUnavailable(Box<ErrorDetails>)

503/502/504 / ServiceUnavailable

InternalServer(Box<ErrorDetails>)

500 / InternalServerException

MissingApiKey

No API key could be resolved from config or environment.

Sdk

Client-side failure. Per spec §4 only network-level failures are retryable; JSON-decode failures and malformed 200 bodies are not.

Fields

message: String

retryable: bool

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Returns true if this error is retryable per the spec retry policy.

pub fn retry_after_seconds(&self) -> Option<f64>

Returns the Retry-After value if this error carries one.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.