Struct EmbeddingRequest 

pub struct EmbeddingRequest {
    pub model: String,
    pub input: EmbeddingInput,
    pub dimensions: Option<usize>,
    pub encoding_format: Option<EncodingFormat>,
    pub input_type: Option<EmbeddingInputType>,
}

Request for generating embeddings.

Fields

model: String

The embedding model to use (e.g., “text-embedding-3-small”).

input: EmbeddingInput

The input text(s) to embed.

dimensions: Option<usize>

Optional: Number of dimensions for the output embedding. Only supported by some models (e.g., OpenAI text-embedding-3-*).

encoding_format: Option<EncodingFormat>

Optional: Output encoding format.

input_type: Option<EmbeddingInputType>

Optional: Input type hint for optimized embeddings. Supported by some providers like Voyage AI.

Implementations

impl EmbeddingRequest

pub fn new(model: impl Into<String>, text: impl Into<String>) -> Self

Create a new embedding request for a single text.

pub fn batch(model: impl Into<String>, texts: Vec<impl Into<String>>) -> Self

Create a new embedding request for multiple texts (batch).

pub fn with_dimensions(self, dimensions: usize) -> Self

Set the output dimensions (for models that support dimension reduction).

pub fn with_encoding_format(self, format: EncodingFormat) -> Self

Set the encoding format.

pub fn with_input_type(self, input_type: EmbeddingInputType) -> Self

Set the input type hint.

pub fn text_count(&self) -> usize

Get the number of texts to embed.

pub fn texts(&self) -> Vec<&str>

Get all input texts as a vector.

Trait Implementations

impl Clone for EmbeddingRequest

fn clone(&self) -> EmbeddingRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddingRequest

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

Formats the value using the given formatter.