# LangChain 集成

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

来源：https://qd.zsopc.com/docs/integrations/langchain

> [LangChain](https://docs.langchain.com) 的三家模型类都能改 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](https://qd.zsopc.com/dashboard/keys) 创建 API Key,下面的示例从环境变量读它:

```bash
export PLATFORM_API_KEY="sk-gpushare-xxx"
```

## Python

```bash
pip install -U langchain-openai langchain-anthropic langchain-google-genai
```

### ChatOpenAI(OpenAI 协议,可调全部文本模型)

```python
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` 见 [兼容矩阵](../reference/compatibility-matrix.md)。
- 除了 `base_url`,也可以用环境变量 `OPENAI_BASE_URL`。

### ChatAnthropic(Anthropic 协议)

```python
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 协议)

```python
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

```bash
npm install @langchain/openai @langchain/anthropic
```

```ts
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 模型由网关做协议翻译。
- 要用某家协议独有的请求参数:用对应厂商的类。
- 工具调用在三种协议上都能用,细节见 [工具调用](../guides/tool-calling.md)。

## 常见问题

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

错误码完整说明见 [错误码](../reference/errors.md)。

## 相关页面

- [OpenAI SDK](../sdks/openai-sdk.md) / [Anthropic SDK](../sdks/anthropic-sdk.md) / [Gemini SDK](../sdks/gemini-sdk.md) — 三套 SDK 的完整示例
- [LiteLLM](./litellm.md) — 统一调用层与 Proxy
- [Vercel AI SDK](./vercel-ai-sdk.md) — TypeScript 应用框架
