Base URL 应该如何填写？

将 Sub2API 接入各类客户端、SDK 或第三方工具时，正确填写 Base URL 是第一步。本文列出正确的写法以及常见的错误格式，帮助你快速排查连接问题。

正确的 Base URL

Sub2API 的 Base URL 为：

https://sub2api.ruilinlu.com

在大多数 OpenAI 兼容客户端中，你只需将这个地址填入 Base URL 字段即可。部分客户端会自动在末尾追加 /v1，因此在填写前请先确认你所用工具的文档说明。

正确与错误写法对照

写法	是否正确	说明
`https://sub2api.ruilinlu.com`	正确	标准格式，不带尾部斜杠或版本路径
`http://sub2api.ruilinlu.com`	错误	必须使用 HTTPS，HTTP 会被拒绝
`https://sub2api.ruilinlu.com/v1`	视情况	部分客户端要求填写 `/v1`，但多数客户端会自动追加
`https://api.openai.com`	错误	这是 OpenAI 的官方地址，不是 Sub2API 的
`https://sub2api.ruilinlu.com/`	通常可用	带尾部斜杠一般不影响，但建议保持简洁

如果你在配置中填了 https://sub2api.ruilinlu.com/v1，而客户端本身又会自动追加 /v1，最终请求会变成 /v1/v1/chat/completions，导致 404。

常见客户端配置示例

Python (OpenAI SDK)
Node.js (OpenAI SDK)
LangChain

from openai import OpenAI

client = OpenAI(
    base_url="https://sub2api.ruilinlu.com/v1",  # SDK 不会自动追加 /v1，需手动加上
    api_key="YOUR_API_KEY",
)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://sub2api.ruilinlu.com/v1',
  apiKey: 'YOUR_API_KEY',
});

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://sub2api.ruilinlu.com/v1",
    api_key="YOUR_API_KEY",
    model="gpt-4o"
)

不确定是否该加 /v1 时，可以先发一个测试请求。如果遇到 404，尝试切换带 /v1 和不带 /v1 的写法。

更详细的配置指南，包括各语言和框架的完整示例，请参考 Base URL 配置。

​正确的 Base URL

​正确与错误写法对照

​常见客户端配置示例

正确的 Base URL

正确与错误写法对照

常见客户端配置示例