Skip to main content

Interface: EmbedTextResult

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

The result returned by embedText.

Example​

const { embeddings, usage } = await embedText({
provider: 'openai',
model: 'text-embedding-3-small',
input: ['Hello', 'World'],
});
console.log(embeddings.length); // 2
console.log(embeddings[0].length); // e.g. 1536

Properties​

embeddings​

embeddings: number[][]

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

One embedding vector per input string. Each vector is a plain number[] of floats whose dimensionality depends on the model (and the optional dimensions parameter).


model​

model: string

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

Model identifier reported by the provider (may differ from the requested model).


provider​

provider: string

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

Provider identifier used for the run.


usage​

usage: object

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

Token usage for the embedding request. Most embedding APIs only report prompt tokens (the input); completion tokens are typically zero.

costUSD?​

optional costUSD: number

Cost in USD: Gemini's when it prices the call itself (embedding models with a catalog price), and an OpenAI embedding model's from OpenAI's price table. Absent when neither is known.

promptTokens​

promptTokens: number

Number of tokens consumed by the input text(s).

totalTokens​

totalTokens: number

Sum of prompt and any other tokens (usually equal to promptTokens).