> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sub2api.ruilinlu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Base URL 应该如何填写？

> 不同客户端和 SDK 中 Base URL 的正确填写方式和常见错误写法的识别与纠正。

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

## 正确的 Base URL

Sub2API 的 Base URL 为：

```text theme={null}
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/`   | 通常可用 | 带尾部斜杠一般不影响，但建议保持简洁           |

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

## 常见客户端配置示例

<Tabs>
  <Tab title="Python (OpenAI SDK)">
    ```python theme={null}
    from openai import OpenAI

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

  <Tab title="Node.js (OpenAI SDK)">
    ```javascript theme={null}
    import OpenAI from 'openai';

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

  <Tab title="LangChain">
    ```python theme={null}
    from langchain_openai import ChatOpenAI

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

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

更详细的配置指南，包括各语言和框架的完整示例，请参考 [Base URL 配置](/configuration/base-url)。