Skip to main content

Interface: EmbedTextOptions

Defined in: packages/agentos/src/api/embedText.ts:38

Options for an embedText call.

At minimum, input must be provided. Provider/model resolution follows the same rules as generateText: supply provider, model (optionally in provider:model format), or rely on env-var auto-detection.

Example​

const opts: EmbedTextOptions = {
  model: 'openai:text-embedding-3-small',
  input: ['Hello world', 'Goodbye world'],
  dimensions: 256,
};

Properties​

apiKey?​

optional apiKey: string

Defined in: packages/agentos/src/api/embedText.ts:76

Override the API key instead of reading from environment variables.

baseUrl?​

optional baseUrl: string

Defined in: packages/agentos/src/api/embedText.ts:79

Override the provider base URL (useful for local proxies or Ollama).

dimensions?​

optional dimensions: number

Defined in: packages/agentos/src/api/embedText.ts:73

Desired output dimensionality. Only honoured by models that support dimension reduction (e.g. OpenAI text-embedding-3-* with dimensions). Ignored when the model has a fixed output size.

input​

input: string | string[]

Defined in: packages/agentos/src/api/embedText.ts:66

Text(s) to embed. Pass a single string for one embedding or an array for batch processing.

Example​

// Single input
input: 'Hello world'
// Batch input
input: ['Hello world', 'Goodbye world']

model?​

optional model: string

Defined in: packages/agentos/src/api/embedText.ts:52

Model identifier. Accepts "provider:model" or plain model name with provider.

Example​

`"openai:text-embedding-3-small"`, `"nomic-embed-text"`

provider?​

optional provider: string

Defined in: packages/agentos/src/api/embedText.ts:45

Provider name. When supplied without model, the default embedding model for the provider is resolved automatically from the built-in defaults.

Example​

`"openai"`, `"ollama"`, `"openrouter"`

usageLedger?​

optional usageLedger: AgentOSUsageLedgerOptions

Defined in: packages/agentos/src/api/embedText.ts:82

Optional durable usage ledger configuration for helper-level accounting.