APIrove

首页 / 博客 / LangChain 自定义 Base URL

LANGCHAIN · API 集成 · 阅读约 6 分钟

LangChain ChatOpenAI 如何设置自定义 Base URL

通过设置 base_url、API Key 和账户可用的模型 ID,让 LangChain 的 ChatOpenAI 指向 OpenAI 兼容接口。最终能否调用,还取决于具体服务端点和模型能力。

APIrove · 2026 年 10 月 15 日

开始前准备

你需要安装 LangChain 的 OpenAI 集成包、目标服务提供的 API Key,以及当前账户有权限使用的准确模型 ID。自定义 Base URL 只会改变 SDK 请求发送到哪里;它不会自动授予模型权限,也不会让所有 OpenAI 功能都可用。

APIrove 当前公开文档中的 Base URL 是 https://apirove.com/v1。请查看模型列表,登录后核对自己的模型权限和价格;端点说明见API 文档。

在 Python 中配置 LangChain ChatOpenAI

安装集成包:

python -m pip install -U langchain-openai

把密钥和模型 ID 放在服务端环境变量中。不要把真实密钥写进会分享的 Notebook、浏览器代码或公开代码仓库。

export APIROVE_API_KEY="你的 API Key"
export APIROVE_MODEL_ID="账户已开通的模型 ID"

然后配置 ChatOpenAI 使用兼容的 Chat Completions 接口:

import os
from langchain_openai import ChatOpenAI

model = ChatOpenAI(
    model=os.environ["APIROVE_MODEL_ID"],
    api_key=os.environ["APIROVE_API_KEY"],
    base_url="https://apirove.com/v1",
    use_responses_api=False,
)

reply = model.invoke("请回复:连接测试通过。")
print(reply.content)

示例中的模型 ID 是占位符。请替换为账户实际可用的模型,并确认该模型支持 Chat Completions。use_responses_api=False 让这次 LangChain 调用使用 /v1/chat/completions 请求格式;这不代表所有模型都接受相同参数。

确实需要时,再单独测试流式输出

普通请求成功后,可以单独测试流式响应:

for chunk in model.stream("从一数到三。"):
    if chunk.content:
        print(chunk.content, end="", flush=True)

不同模型和兼容服务的流式行为、返回元数据可能不同。应用依赖哪些返回字段,就用对应模型逐项验证;不要默认所有服务都会保留其特有字段。

逐项验证这次接入

  1. 确认 Base URL 包含 /v1,API Key 属于该目标服务。
  2. 确认模型 ID 已对当前账户开放,并支持你选择的端点。
  3. 先用短提示词和较小输出限制,检查返回内容及模型信息。
  4. 如果应用需要流式输出、工具调用、JSON 格式或多模态输入,使用准确模型分别验证。
  5. 增加调用量前,检查账户用量和实际价格。

LangChain 文档将 base_url 列为客户端配置,并说明 ChatOpenAI 面向标准 OpenAI API 规格。第三方服务的非标准响应字段可能不会被提取或保留。请查看LangChain ChatOpenAI 官方参考了解当前版本行为。

常见配置问题

  • 401:检查密钥是否存在、复制是否完整,以及密钥服务是否与 base_url 对应。
  • 403:核对账户权限和所选模型是否已开通。
  • 400 或找不到资源:检查端点路径、模型 ID 和请求格式是否匹配。
  • 429:查看账户限额及响应提示后再决定是否重试。
  • 5xx 或超时:记录响应中的请求 ID;避免快速重复请求导致调用叠加。
本文介绍配置方式,不代表所有 LangChain 版本、模型、参数或 APIrove 账户都已完成实时联调。请在自己的账户中核对当前模型权限与行为。概念介绍可阅读OpenAI 兼容 API 接入指南。