SDK 接入
2026/5/20小于 1 分钟
PulseNeko Bridge 同时兼容三大主流协议,原生 SDK 几乎不用改代码,只需要换 base_url 和 api_key。
协议一览
| 协议 | Base URL | SDK |
|---|---|---|
| OpenAI Chat / Responses | https://bridge.pulseneko.com/v1 | openai、@ai-sdk/openai、官方各语言 SDK |
| Anthropic Messages | https://bridge.pulseneko.com | anthropic |
| Gemini 原生 | https://bridge.pulseneko.com/gemini | google-genai、@google/genai |
跨语言:
- Python、Node.js、Go、Java、Rust 等都有 OpenAI / Anthropic / Gemini 官方 SDK
- 任何不在列表里的语言,直接 HTTP 调用 + Bearer 鉴权即可
上层框架
| 框架 | 怎么接 |
|---|---|
| LangChain | 把 LLM 的 base_url / openai_api_base 改成 Bridge |
| LlamaIndex | 同上 |
| Vercel AI SDK | 用 @ai-sdk/openai,设 baseURL |
| 自家 RAG / Agent | 通常都用 OpenAI 兼容路径就够了 |
分语言文档
- OpenAI 兼容 SDK — Python / Node / cURL
- Anthropic SDK — Claude 系列
- Gemini SDK — Google 原生
- LangChain — 框架接入
通用注意
- 超时:默认 SDK 超时通常 60s,长上下文 / 推理模型建议设到 300s+
- 流式:所有 SDK 默认支持
stream=True,Bridge 直接转发 SSE 流 - 重试:网络抖动时让 SDK 自带重试
max_retries=2,避免吃502/504 - 多线程:客户端实例可以全局共享,按需求并发即可