一个 LangChain 集成,覆盖所有模型系列
LangChain 应用通常每个模型系列都要接一个 provider 类。Router One 是 OpenAI 兼容的,所以一份 ChatOpenAI 配置就能调 GPT、Claude、Gemini、DeepSeek 等系列——换模型只改字符串,代码不动。链路和 agent 的每一步在网关侧都有成本 trace,不用自己加 callback。
配置
把 base URL 和 key 传给 ChatOpenAI(Python)或 @langchain/openai 的 ChatOpenAI(JS/TS):
langchain_example.py
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.router.one/v1",
api_key="sk-your-router-one-key",
model="<model-id-from-/models>",
)
print(llm.invoke("Hello!").content)选择模型
从 /models 页复制精确的模型 ID——ID 区分大小写,页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key,并设置 maxSpend 消费上限,这样单个工具跑飞不会影响其他工作负载。
验证与观测
发出第一个请求后,到 Dashboard → Logs 查看它的完整 trace:模型、tokens、花费、延迟和状态码。LangChain 的每一次调用从此都有账本和轨迹,不再是黑盒。
常见问题
- 还需要装 langchain-anthropic 之类的 provider 包吗?
- 走网关的模型不需要——ChatOpenAI 配上 Router One base URL 即可覆盖目录里所有具备对话能力的模型。切换系列只需改 model 字符串。
- LangChain 能通过网关用哪些模型?
- 目录里任何具备对话能力的模型——GPT、Claude、Gemini、DeepSeek、Mistral 等系列。/models 页是模型 ID 与单价的事实来源。
- 中国大陆能直连吗?
- 能。网关在大陆可直连、无需 VPN,配置与全球环境完全一致。
- 报 401/403/429 怎么排查?
- 先到 Dashboard → Logs 看请求有没有到达网关以及状态码,再对照错误码速查页逐项检查环境变量、Key 状态和限额。