Struct ApiEmbedder 

pub struct ApiEmbedder { /* private fields */ }

Generates embeddings via a remote API endpoint, with hash fallback.

API Mode

When a valid API key is available, sends requests to the provider’s /embeddings endpoint in the OpenAI-compatible format.

Fallback Mode

When no API key is set or the API call fails, produces deterministic pseudo-embeddings using SHA-256 hashing. These are NOT semantically meaningful but provide consistent, reproducible vectors for testing and development workflows.

Implementations

impl ApiEmbedder

pub fn new(config: ApiEmbedderConfig) -> Self

Create a new ApiEmbedder with the given configuration.

pub fn with_defaults() -> Self

Create an ApiEmbedder with default configuration (OpenAI, 384-dim).

pub fn hash_only(dimension: usize) -> Self

Create a fallback-only embedder that never calls an API.

Useful for testing or environments without API access.

pub fn hash_fallback(&self, text: &str) -> Vec<f32>

Generate a deterministic pseudo-embedding from text using SHA-256.

This is NOT semantically meaningful – it is a fallback for when no API is available. The output is deterministic: same input always produces the same vector.

Trait Implementations

impl Embedder for ApiEmbedder

fn embed<'life0, 'life1, 'async_trait>( &'life0 self, text: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<f32>, EmbeddingError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Generate a vector embedding for the given text.

fn embed_batch<'life0, 'life1, 'async_trait>( &'life0 self, texts: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<Vec<Vec<f32>>, EmbeddingError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Batch embed multiple texts.

fn dimension(&self) -> usize

Return the dimensionality of embeddings produced by this embedder.

fn name(&self) -> &str

Return the name/identifier of this embedder (e.g. “hash”, “openai-text-embedding-3-small”).