Embedding options including model, input text(s), and optional provider/key overrides.
A promise resolving to the embedding vectors, provider metadata, and token usage.
When provider resolution fails (missing API key, unknown provider, etc.).
When the embedding API returns a non-2xx status.
import { embedText } from '@framers/agentos';
// Single input
const { embeddings } = await embedText({
model: 'openai:text-embedding-3-small',
input: 'Hello world',
});
console.log(embeddings[0].length); // 1536
// Batch with reduced dimensions
const batch = await embedText({
model: 'openai:text-embedding-3-small',
input: ['Hello', 'World'],
dimensions: 256,
});
console.log(batch.embeddings.length); // 2
console.log(batch.embeddings[0].length); // 256
Generates embedding vectors for one or more text inputs using a provider-agnostic
provider:modelstring.Resolves credentials via the standard AgentOS provider pipeline, then dispatches to the appropriate embedding endpoint (OpenAI, Ollama, or OpenRouter). Returns raw float arrays suitable for vector similarity search, clustering, or any downstream ML pipeline.