Struct ApiEmbedding 

pub struct ApiEmbedding { /* private fields */ }

API-based embedding provider (OpenAI, Anthropic, Cohere, etc.)

Supports any API that accepts JSON and returns embeddings in a standard format.

Example (OpenAI)

use ruvector_core::embeddings::{EmbeddingProvider, ApiEmbedding};

let provider = ApiEmbedding::openai("sk-...", "text-embedding-3-small", identity)?;
let embedding = provider.embed("hello world")?;

Implementations

impl ApiEmbedding

pub fn new( api_key: String, endpoint: String, model: String, dimensions: usize, identity: EmbeddingSpaceIdentity, ) -> Result<Self>

Create a new API embedding provider

Arguments

• api_key - API key for authentication
• endpoint - API endpoint URL
• model - Model identifier
• dimensions - Expected embedding dimensions

pub fn openai( api_key: &str, model: &str, identity: EmbeddingSpaceIdentity, ) -> Result<Self>

Create OpenAI embedding provider

Models

• text-embedding-3-small - 1536 dimensions, $0.02/1M tokens
• text-embedding-3-large - 3072 dimensions, $0.13/1M tokens
• text-embedding-ada-002 - 1536 dimensions (legacy)

pub fn cohere( api_key: &str, model: &str, identity: EmbeddingSpaceIdentity, ) -> Result<Self>

Create Cohere embedding provider

Models

• embed-english-v3.0 - 1024 dimensions
• embed-multilingual-v3.0 - 1024 dimensions

pub fn voyage( api_key: &str, model: &str, identity: EmbeddingSpaceIdentity, ) -> Result<Self>

Create Voyage AI embedding provider

Models

• voyage-2 - 1024 dimensions
• voyage-large-2 - 1536 dimensions

Trait Implementations

impl Clone for ApiEmbedding

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl EmbeddingProvider for ApiEmbedding

Available on crate feature api-embeddings only.

fn embed_for(&self, role: EmbeddingRole, text: &str) -> Result<Vec<f32>>

fn embedding_space(&self) -> &EmbeddingSpaceIdentity

fn dimensions(&self) -> usize

Get the dimensionality of embeddings produced by this provider

fn name(&self) -> &str

Get a description of this provider (for logging/debugging)

fn embed_query(&self, text: &str) -> Result<Vec<f32>>

fn embed_passage(&self, text: &str) -> Result<Vec<f32>>

fn embed(&self, text: &str) -> Result<Vec<f32>>

👎Deprecated:

use embed_query or embed_passage

fn embed_batch_for( &self, role: EmbeddingRole, texts: &[&str], ) -> Result<Vec<Vec<f32>>>

fn embed_query_batch(&self, texts: &[&str]) -> Result<Vec<Vec<f32>>>

fn embed_passage_batch(&self, texts: &[&str]) -> Result<Vec<Vec<f32>>>