@router-brain/sdk 是 Router Brain 网关的官方 Node.js / TypeScript 客户端。一个 API Key 即可访问 LLM 对话、图像生成、模型检索等全部能力。
能做什么
- 对话应用 — 支持流式输出、函数调用、文本向量化
- 图像生成 — 支持同步生成和异步任务两种模式
- 模型检索 — 搜索、筛选、对比可用模型
- 内容重排 — 对文档按相关性排序，用于 RAG 流程
适用场景
| 适合 | 不适合 |
|---|
| Node.js 后端、Serverless、CLI 工具 | 浏览器直连（Key 不能暴露在前端） |
| TypeScript 项目（完整类型支持） | Node.js 18 以下环境 |
核心能力
| 想做什么 | 怎么做 |
|---|
| 对话（OpenAI 协议） | rb.openai().chat.completions.create(...) |
| 对话（Anthropic 协议） | rb.anthropic().messages.create(...) |
| 文本向量化 | rb.openai().embeddings.create(...) |
| 图像生成 | rb.image(...).json() |
| 图像流式生成 | rb.image(...).stream() |
| 搜索模型 | rb.models(...) |
| 查模型详情 | rb.modelEndpoint(...) |
| 文档重排 | rb.rerank(...) |
快速开始
import { RouterBrain } from '@router-brain/sdk';
const rb = new RouterBrain('sk-your-api-key');
// 第一次对话
const res = await rb.openai().chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好！' }],
});
console.log(res.choices[0].message.content);
下一步
安装 → 初始化 → 对话与流式