Skip to content

IEmbeddingGenerator Feature Matrix

The IEmbeddingGenerator<string, Embedding<float>> interface provides a unified API for text embeddings across all supported providers.

Feature comparison

Feature Ollama OpenAI Gemini Cohere Together HuggingFace Jina VoyageAI
Single input Y Y Y Y Y Y Y Y
Batch input Y Y Y Y Y Y Y Y
Custom dimensions Y Y - - - Y Y Y
Token usage Y Y - - - Y Y Y

Universal code example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
using Microsoft.Extensions.AI;

IEmbeddingGenerator<string, Embedding<float>> generator = /* any provider */;

// Single embedding
var embedding = await generator.GenerateAsync("Hello, world!");
float[] vector = embedding[0].Vector.ToArray();

// Batch embeddings
var embeddings = await generator.GenerateAsync([
    "First document",
    "Second document",
    "Third document"
]);

Provider-specific initialization

1
2
3
IEmbeddingGenerator<string, Embedding<float>> generator =
    new OpenAiClient(apiKey)
        .AsEmbeddingGenerator("text-embedding-3-small");

1
2
3
IEmbeddingGenerator<string, Embedding<float>> generator =
    new OllamaApiClient()
        .AsEmbeddingGenerator("nomic-embed-text");

1
2
3
IEmbeddingGenerator<string, Embedding<float>> generator =
    new JinaClient(apiKey)
        .AsEmbeddingGenerator("jina-embeddings-v3");

1
2
3
IEmbeddingGenerator<string, Embedding<float>> generator =
    new VoyageAiClient(apiKey)
        .AsEmbeddingGenerator("voyage-3");

Per-SDK documentation

SDK Documentation
Ollama tryagi.github.io/Ollama/guides/meai/
OpenAI tryagi.github.io/OpenAI/guides/meai/
Google.Gemini tryagi.github.io/Google_Generative_AI/guides/meai/
Cohere tryagi.github.io/Cohere/guides/meai/
Together tryagi.github.io/Together/guides/meai/
HuggingFace tryagi.github.io/HuggingFace/guides/meai/
Jina tryagi.github.io/Jina/guides/meai/
VoyageAI tryagi.github.io/VoyageAI/guides/meai/