Enum Error 

pub enum Error {
    Validation(ErrorDetails),
    AccessDenied(ErrorDetails),
    ServiceQuotaExceeded(ErrorDetails),
    ResourceNotFound(ErrorDetails),
    Throttling(ErrorDetails),
    ModelTimeout(ErrorDetails),
    ModelError(ErrorDetails),
    ModelStreamError(ErrorDetails),
    ServiceUnavailable(ErrorDetails),
    InternalServer(ErrorDetails),
    MissingApiKey,
    Sdk(String),
}

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

Variants

Validation(ErrorDetails)

400 / invalid_request_error / VALIDATION_ERROR

AccessDenied(ErrorDetails)

401/403 / authentication_error / AUTHORIZATION_ERROR / MODEL_NOT_ALLOWED

ServiceQuotaExceeded(ErrorDetails)

402 / usage_cap_exceeded / BUDGET_EXCEEDED

ResourceNotFound(ErrorDetails)

404 / MODEL_NOT_FOUND

Throttling(ErrorDetails)

429 (retryable) / rate_limit_exceeded / RATE_LIMIT_EXCEEDED

ModelTimeout(ErrorDetails)

408 / TIMEOUT_ERROR

ModelError(ErrorDetails)

5xx model-side error

ModelStreamError(ErrorDetails)

Stream-specific error (subtype of ModelError)

ServiceUnavailable(ErrorDetails)

503/502/504 / ServiceUnavailable

InternalServer(ErrorDetails)

500 / InternalServerException

MissingApiKey

No API key could be resolved from config or environment.

Sdk(String)

Network / decode failures (retryable on network errors).

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.