@objectstack/embedder-openai

OpenAI-compatible embedder for ObjectStack. Works against any endpoint that speaks the POST /v1/embeddings shape:

| Provider | baseUrl | Typical model | |---|---|---| | OpenAI | https://api.openai.com/v1 | text-embedding-3-small | | Azure OpenAI | https://{resource}.openai.azure.com/openai/deployments/{deployment} | (deployment name) | | 阿里通义 DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 | text-embedding-v3 | | 智谱 BigModel | https://open.bigmodel.cn/api/paas/v4 | embedding-3 | | 硅基流动 SiliconFlow | https://api.siliconflow.cn/v1 | BAAI/bge-m3 | | 火山引擎 Doubao | https://ark.cn-beijing.volces.com/api/v3 | doubao-embedding-large-text-240915 | | MiniMax | https://api.minimax.chat/v1 | embo-01 | | Ollama (local) | http://localhost:11434/v1 | bge-m3, nomic-embed-text | | LiteLLM / vLLM / 自建网关 | (your endpoint) | (your model) |

Implements IEmbedder from @objectstack/spec/contracts — drop directly into any knowledge adapter (e.g. @objectstack/knowledge-turso).

Install

pnpm add @objectstack/embedder-openai

Usage

OpenAI

import { OpenAIEmbedder } from '@objectstack/embedder-openai';

const embedder = new OpenAIEmbedder({
  apiKey: process.env.OPENAI_API_KEY!,
  model: 'text-embedding-3-small', // default
});

阿里通义 DashScope

import { createOpenAIEmbedder } from '@objectstack/embedder-openai';

const embedder = createOpenAIEmbedder({
  preset: 'dashscope',
  apiKey: process.env.DASHSCOPE_API_KEY!,
  model: 'text-embedding-v3',
});

硅基流动 SiliconFlow（推荐桌面端）

const embedder = createOpenAIEmbedder({
  preset: 'siliconflow',
  apiKey: process.env.SILICONFLOW_API_KEY!,
  model: 'BAAI/bge-m3',
});

Ollama（完全离线）

const embedder = createOpenAIEmbedder({
  preset: 'ollama',
  apiKey: 'ollama', // ignored by ollama but required by interface
  model: 'bge-m3',
});

智谱 BigModel

const embedder = createOpenAIEmbedder({
  preset: 'zhipu',
  apiKey: process.env.ZHIPU_API_KEY!,
  model: 'embedding-3',
});

Plug into a knowledge adapter

import { OpenAIEmbedder } from '@objectstack/embedder-openai';
import { KnowledgeTursoPlugin } from '@objectstack/knowledge-turso';

const embedder = new OpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });

kernel.use(new KnowledgeTursoPlugin({
  url: 'libsql://your-tenant.turso.io',
  authToken: env.TURSO_TOKEN,
  embedding: embedder,
}));

Options

| Option | Default | Description | |---|---|---| | apiKey | — (required) | Bearer token. | | model | 'text-embedding-3-small' | Upstream model id. | | dimensions | (model default) | Override output dim (Matryoshka models only). | | baseUrl | 'https://api.openai.com/v1' | Endpoint root (no /embeddings). | | id | 'openai' | Stable id surfaced as IEmbedder.id. | | headers | {} | Extra request headers. | | fetch | globalThis.fetch | Inject for tests / custom transport. |

Contract

Implements IEmbedder:

interface IEmbedder {
  readonly id: string;
  readonly dimensions: number;
  embed(texts: string[]): Promise<number[][]>;
}

License

Apache-2.0. See LICENSING.md.