Enum EmbeddingError 

pub enum EmbeddingError {
    NotConfigured {
        alias: String,
    },
    UnknownModel {
        alias: String,
        available: Vec<String>,
    },
    InputTooLong {
        alias: String,
        index: Option<usize>,
        limit: Option<u64>,
        settlements: Vec<SubBatchSettlement>,
    },
    BoundsExceeded {
        alias: String,
        kind: EmbeddingBoundKind,
        actual: u64,
        limit: u64,
    },
    BudgetExceeded {
        alias: String,
        limit_kind: EmbeddingLimitKind,
        settlements: Vec<SubBatchSettlement>,
    },
    Unauthorized {
        alias: String,
        settlements: Vec<SubBatchSettlement>,
    },
    Provider {
        alias: String,
        reason: EmbeddingFailureReason,
        settlements: Vec<SubBatchSettlement>,
    },
    Malformed {
        alias: String,
        reason: EmbeddingMalformedReason,
        settlements: Vec<SubBatchSettlement>,
    },
    Internal {
        alias: String,
        settlements: Vec<SubBatchSettlement>,
    },
}

Why an embedding call failed. Variants after the pre-send group carry the settlements of every sub-batch that was sent before the failure.

None carries input text.

Variants

NotConfigured

Fields

alias: String

UnknownModel

Fields

alias: String

available: Vec<String>

InputTooLong

An input exceeds the alias’s max_input_bytes, or the provider rejected one as too long. index names the input when known. limit is the byte limit for the pre-send check and None for a provider-side rejection, which carries the settlements of sub-batches already sent.

Fields

alias: String

index: Option<usize>

limit: Option<u64>

settlements: Vec<SubBatchSettlement>

BoundsExceeded

Fields

alias: String

kind: EmbeddingBoundKind

actual: u64

limit: u64

BudgetExceeded

A ceiling refused the call. Pre-send, settlements is empty; the request cap can also trip between sub-batches.

Fields

alias: String

limit_kind: EmbeddingLimitKind

settlements: Vec<SubBatchSettlement>

Unauthorized

Fields

alias: String

settlements: Vec<SubBatchSettlement>

Provider

Fields

alias: String

reason: EmbeddingFailureReason

settlements: Vec<SubBatchSettlement>

Malformed

Fields

alias: String

reason: EmbeddingMalformedReason

settlements: Vec<SubBatchSettlement>

Internal

The provider’s own bookkeeping failed (a closed pool, a missing slot). Never guest-catchable: the stdlib settles the budget and ends the run.

Fields

alias: String

settlements: Vec<SubBatchSettlement>

Implementations

impl EmbeddingError

pub fn alias(&self) -> &str

pub fn settlements(&self) -> &[SubBatchSettlement]

Per-sub-batch settlements carried by a post-send failure; empty for pre-send variants.

pub fn is_budget_exceeded(&self) -> bool

Token-budget refusals become catchable QuotaExceededErrors at the stdlib boundary.

pub fn is_internal(&self) -> bool

A provider-side invariant failure that must end the run.

pub fn with_settlements(self, collected: Vec<SubBatchSettlement>) -> Self

Attach settlements to a failure raised by EmbeddingTokenBudget::mark_sent or built before the provider had them. A no-op on pre-send variants.

Trait Implementations

impl Clone for EmbeddingError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddingError

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

Formats the value using the given formatter.

impl Display for EmbeddingError

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

Formats the value using the given formatter.

impl Eq for EmbeddingError

impl Error for EmbeddingError

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 PartialEq for EmbeddingError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for EmbeddingError