LangChain 集成

LangChain 的 ChatOpenAI / ChatAnthropic / ChatGoogleGenerativeAI 换一个 base URL 接入本平台 (Python / JS)

LangChain 的三家模型类都能改 base URL,代码其余部分不用动。本页按以下版本的官方文档与源码核对(2026-11-15):Python langchain-openai 1.8.0、langchain-anthropic 1.7.10、langchain-google-genai 4.5.0;JS @langchain/openai 1.8.4、@langchain/anthropic 1.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 模型由网关做协议翻译。
  • 要用某家协议独有的请求参数:用对应厂商的类。
  • 工具调用在三种协议上都能用,细节见 工具调用。

常见问题#

现象排查
404OpenAI 的 base URL 要带 /v1;Anthropic、Gemini 的不带
401 invalid_api_keyKey 是否复制完整(共 76 字符);环境变量是否真的传进了进程
400 model_not_found模型 ID 拼写,须与 模型列表 一致
流式拿不到 token 用量ChatOpenAI 加 stream_usage=True
402 quota_exceeded余额不足。所有 Key 共享同一账户余额,到 充值页 充值

错误码完整说明见 错误码。

相关页面#