LangChain 集成
LangChain 的 ChatOpenAI / ChatAnthropic / ChatGoogleGenerativeAI 换一个 base URL 接入本平台 (Python / JS)
LangChain 的三家模型类都能改 base URL,代码其余部分不用动。本页按以下版本的官方文档与源码核对(2026-11-15):Python
langchain-openai1.8.0、langchain-anthropic1.7.10、langchain-google-genai4.5.0;JS@langchain/openai1.8.4、@langchain/anthropic1.6.5。
准备 API Key#
在 qd.zsopc.com/dashboard/keys 创建 API Key,下面的示例从环境变量读它:
export PLATFORM_API_KEY="sk-gpushare-xxx"
Python#
pip install -U langchain-openai langchain-anthropic langchain-google-genai
ChatOpenAI(OpenAI 协议,可调全部文本模型)#
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="gpt-6.1-sol", # 换成 claude-sonnet-4-6、deepseek-v4.1-flash 等也行
base_url="https://qd.zsopc.com/v1",
api_key=os.environ["PLATFORM_API_KEY"],
stream_usage=True, # 自定义 base_url 时默认关闭;打开后流式也带 token 用量
)
print(llm.invoke("用一句话介绍你自己").content)
- 想走
/v1/responses,传use_responses_api=True。不传时 LangChain 可能按模型名或所用工具自动改用 Responses API,接第三方端点时建议显式写上True或False。哪些模型支持/v1/responses见 兼容矩阵。 - 除了
base_url,也可以用环境变量OPENAI_BASE_URL。
ChatAnthropic(Anthropic 协议)#
from langchain_anthropic import ChatAnthropic
claude = ChatAnthropic(
model="claude-sonnet-4-6",
base_url="https://qd.zsopc.com", # 不带 /v1,SDK 自己补 /v1/messages
api_key=os.environ["PLATFORM_API_KEY"],
)
本平台在 /v1/messages 上同时接受 x-api-key 与 Authorization: Bearer 两种鉴权头,不同版本的 anthropic SDK 都能直接用。
ChatGoogleGenerativeAI(Gemini 协议)#
from langchain_google_genai import ChatGoogleGenerativeAI
gemini = ChatGoogleGenerativeAI(
model="gemini-3.1-pro-low",
base_url="https://qd.zsopc.com",
api_version="v1beta",
api_key=os.environ["PLATFORM_API_KEY"],
)
JavaScript / TypeScript#
npm install @langchain/openai @langchain/anthropic
import { ChatOpenAI } from "@langchain/openai";
import { ChatAnthropic } from "@langchain/anthropic";
const llm = new ChatOpenAI({
model: "gpt-6.1-sol",
apiKey: process.env.PLATFORM_API_KEY,
configuration: { baseURL: "https://qd.zsopc.com/v1" },
});
const claude = new ChatAnthropic({
model: "claude-sonnet-4-6",
apiKey: process.env.PLATFORM_API_KEY,
anthropicApiUrl: "https://qd.zsopc.com", // 不带 /v1
});
console.log((await llm.invoke("Hello")).content);
选哪个类#
- 只想一套代码调所有厂商:用
ChatOpenAI。Claude、Gemini 等非 OpenAI 模型由网关做协议翻译。 - 要用某家协议独有的请求参数:用对应厂商的类。
- 工具调用在三种协议上都能用,细节见 工具调用。
常见问题#
| 现象 | 排查 |
|---|---|
| 404 | OpenAI 的 base URL 要带 /v1;Anthropic、Gemini 的不带 |
401 invalid_api_key | Key 是否复制完整(共 76 字符);环境变量是否真的传进了进程 |
400 model_not_found | 模型 ID 拼写,须与 模型列表 一致 |
| 流式拿不到 token 用量 | ChatOpenAI 加 stream_usage=True |
402 quota_exceeded | 余额不足。所有 Key 共享同一账户余额,到 充值页 充值 |
错误码完整说明见 错误码。
相关页面#
- OpenAI SDK / Anthropic SDK / Gemini SDK — 三套 SDK 的完整示例
- LiteLLM — 统一调用层与 Proxy
- Vercel AI SDK — TypeScript 应用框架