官方 npm 包 @routerbrain/sdk 适用于 Node.js / TypeScript,封装 OpenAI 兼容的网关 HTTP 能力。
适用场景
| 适合 | 不适合 |
|---|
| Node 后端、Worker、CLI | 浏览器直连(勿暴露 Key) |
| 需要流式 SSE 解析 | 仅要 Anthropic Messages(可用 Anthropic SDK + 改 baseURL) |
| 文件上传、模型列表 | 需要 embeddings HTTP 以外的 SDK 封装(embeddings 请裸 HTTP) |
与裸 HTTP / OpenAI SDK 的关系
┌──────────────────┐ ┌─────────────────────┐
│ @routerbrain/sdk │ │ OpenAI SDK │
│ chat / files / │ │ baseURL → 网关 /v1 │
│ models │ │ │
└────────┬─────────┘ └──────────┬──────────┘
│ │
└──────────┬───────────────┘
▼
https://51kik.com/v1
- 官方 SDK:连连智枢 特有行为(如 PDF 插件字段、请求头)支持更完整。
- OpenAI SDK:改
baseURL + apiKey 即可迁移多数 Chat 代码(见 从 OpenAI 迁移)。
主要模块
| API | 对应 HTTP |
|---|
client.chat.send | POST /chat/completions |
client.files.* | /files |
client.models.list | GET /models |
client.chat.messages(Node) | 多轮 / 文件路径构建辅助 |
下一步
安装 → 初始化 → 对话与流式