官方 SDK
ARouter 提供官方 SDK,全面支持对话补全、流式输出、key 管理和 provider 代理。
Go SDK
现已可用 — 零依赖,生产就绪。go get github.com/arouter-ai/arouter-go
需要 Go 1.21+ · 文档 → Node.js SDK
即将推出 — 完整 TypeScript 支持。预览版 · 文档 → Python SDK
计划中 — 原生 Python SDK,支持异步。开发中 · 上线时间待定
Go SDK
ARouter 官方 Go SDK,轻量、零依赖、符合 Go 惯用风格。
| |
|---|
| 包名 | github.com/arouter-ai/arouter-go |
| 状态 | 稳定版 |
| 最低 Go 版本 | 1.21+ |
| 许可证 | MIT |
| 源码 | GitHub |
功能特性
- 对话补全(单次及流式)
- 多 provider 模型路由
- key 管理(创建、列出、更新、删除)
- Provider 代理,支持直接访问上游
- 结构化错误处理,内置哨兵错误
- 可配置超时时间及自定义 HTTP 客户端
go get github.com/arouter-ai/arouter-go
快速示例
import arouter "github.com/arouter-ai/arouter-go"
client := arouter.NewClient("https://api.arouter.ai", "lr_live_xxxx")
resp, err := client.ChatCompletion(ctx, arouter.ChatCompletionRequest{
Model: "openai/gpt-5.4",
Messages: []arouter.Message{{Role: "user", Content: "Hello!"}},
})
Go SDK 完整文档
查看完整 API 参考、流式示例、key 管理和错误处理。
Node.js SDK(预览版)
TypeScript 优先的 SDK,支持对话补全、流式、key 管理和用量追踪。
| |
|---|
| 包名 | @arouter/sdk |
| 状态 | 预览版(v0.1.0) |
| 运行时 | Node.js 18+ |
| 许可证 | MIT |
| 源码 | GitHub |
功能特性
- 对话补全(单次及流式)
- 完整 TypeScript 类型定义
- key 管理
- 用量追踪与分析
- Provider 代理支持
快速示例
import { ARouter } from "@arouter/sdk";
const router = new ARouter({
apiKey: "lr_live_xxxx",
baseURL: "https://api.arouter.ai",
});
const response = await router.chatCompletion({
model: "openai/gpt-5.4",
messages: [{ role: "user", content: "Hello!" }],
});
Node.js SDK 完整文档
查看完整 API 参考,包括 OpenAI/Anthropic SDK 兼容性指南。
第三方 SDK 兼容性
无需 ARouter SDK 即可快速上手。ARouter 与现有 provider SDK 完全兼容:
| SDK | 语言 | 安装 | 文档 |
|---|
| OpenAI SDK | Python | pip install openai | 指南 → |
| OpenAI SDK | Node.js | npm install openai | 指南 → |
| Anthropic SDK | Python | pip install anthropic | 指南 → |
| Anthropic SDK | Node.js | npm install @anthropic-ai/sdk | 指南 → |
| Gemini SDK | Python | pip install google-generativeai | 指南 → |
| cURL | 任意 | 内置 | 指南 → |
只需将 base_url 改为 https://api.arouter.ai 并设置您的 ARouter API key,所有现有 SDK 代码无需修改即可正常工作。