> ## 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.

# Sub2API API Base URL 配置说明

> 介绍 Sub2API 的 API Base URL 格式，以及在各类客户端和代码中正确填写 Base URL 的方法。

Base URL 是连接客户端与 Sub2API 服务的根地址。在所有 API 请求中，客户端都需要通过 Base URL 定位到 Sub2API 的服务端点。正确配置 Base URL 是完成接入的第一步。

Sub2API 的 API Base URL 为：

```text theme={null}
https://sub2api.ruilinlu.com
```

## 为什么需要设置 Base URL

Sub2API 是一个独立的 AI API 网关服务，与 OpenAI、Anthropic 等平台并不相同。将 Base URL 指向 Sub2API，可以确保你的请求被路由到正确的网关地址，同时继续使用常见的客户端和 SDK 进行调用。

## 在不同场景中填写 Base URL

<Tabs>
  <Tab title="Python">
    在使用 OpenAI Python SDK 时，通过 `base_url` 参数指定 Sub2API 的地址：

    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        api_key="your-api-key",
        base_url="https://sub2api.ruilinlu.com"
    )

    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": "Hello!"}]
    )
    print(response.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Node.js">
    在使用 OpenAI Node.js SDK 时，设置 `baseURL` 属性：

    ```javascript theme={null}
    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: 'your-api-key',
      baseURL: 'https://sub2api.ruilinlu.com',
    });

    const response = await openai.chat.completions.create({
      model: 'gpt-4o',
      messages: [{ role: 'user', content: 'Hello!' }],
    });

    console.log(response.choices[0].message.content);
    ```
  </Tab>

  <Tab title="环境变量">
    你也可以通过环境变量让 SDK 自动读取 Base URL：

    ```bash theme={null}
    export OPENAI_API_KEY="your-api-key"
    export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"
    ```

    在代码中无需显式配置：

    ```python theme={null}
    from openai import OpenAI
    client = OpenAI()  # 自动读取环境变量
    ```

    更多环境变量配置方法，请参考 [环境变量配置](/configuration/env-vars)。
  </Tab>
</Tabs>

<Note>
  请勿在 Base URL 后手动添加 `/v1` 后缀，除非你所使用的客户端明确要求。Sub2API 的请求路径由 SDK 自动生成。
</Note>

## 在客户端应用中粘贴 Base URL

对于支持自定义 API 地址的客户端（如 Cherry Studio、Chatbox、Cursor 等），通常在设置界面找到 **API 地址** 或 **Base URL** 字段，填入以下内容即可：

```text theme={null}
https://sub2api.ruilinlu.com
```

具体位置因客户端而异，请参考对应客户端的配置页面。

<Tip>
  如果你偏好通过环境变量统一管理 API Key 和 Base URL，请查看 [环境变量配置](/configuration/env-vars)。
</Tip>

Base URL 是连接客户端与 Sub2API 服务的根地址。在所有 API 请求中，客户端都需要通过 Base URL 定位到 Sub2API 的服务端点。正确配置 Base URL 是完成接入的第一步。

Sub2API 的 API Base URL 为：

```text theme={null}
https://sub2api.ruilinlu.com
```

## 为什么需要设置 Base URL

Sub2API 是一个独立的 AI API 网关服务，与 OpenAI、Anthropic 等平台并不相同。将 Base URL 指向 Sub2API，可以确保你的请求被路由到正确的网关地址，同时继续使用常见的客户端和 SDK 进行调用。

## 在不同场景中填写 Base URL

<Tabs>
  <Tab title="Python">
    在使用 OpenAI Python SDK 时，通过 `base_url` 参数指定 Sub2API 的地址：

    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        api_key="your-api-key",
        base_url="https://sub2api.ruilinlu.com"
    )

    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": "Hello!"}]
    )
    print(response.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Node.js">
    在使用 OpenAI Node.js SDK 时，设置 `baseURL` 属性：

    ```javascript theme={null}
    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: 'your-api-key',
      baseURL: 'https://sub2api.ruilinlu.com',
    });

    const response = await openai.chat.completions.create({
      model: 'gpt-4o',
      messages: [{ role: 'user', content: 'Hello!' }],
    });

    console.log(response.choices[0].message.content);
    ```
  </Tab>

  <Tab title="环境变量">
    你也可以通过环境变量让 SDK 自动读取 Base URL：

    ```bash theme={null}
    export OPENAI_API_KEY="your-api-key"
    export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"
    ```

    在代码中无需显式配置：

    ```python theme={null}
    from openai import OpenAI
    client = OpenAI()  # 自动读取环境变量
    ```

    更多环境变量配置方法，请参考 [环境变量配置](/configuration/env-vars)。
  </Tab>
</Tabs>

<Note>
  请勿在 Base URL 后手动添加 `/v1` 后缀，除非你所使用的客户端明确要求。Sub2API 的请求路径由 SDK 自动生成。
</Note>

## 在客户端应用中粘贴 Base URL

对于支持自定义 API 地址的客户端（如 Cherry Studio、Chatbox、Cursor 等），通常在设置界面找到 **API 地址** 或 **Base URL** 字段，填入以下内容即可：

```text theme={null}
https://sub2api.ruilinlu.com
```

具体位置因客户端而异，请参考对应客户端的配置页面。

<Tip>
  如果你偏好通过环境变量统一管理 API Key 和 Base URL，请查看 [环境变量配置](/configuration/env-vars)。
</Tip>