Base URL 应该如何填写？

不同客户端和 SDK 中 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)

from openai import OpenAI

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

Node.js (OpenAI SDK)

import OpenAI from 'openai';

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

LangChain

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 配置。