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

# Windows 上使用 Sub2API 的完整指南

> 在 Windows 上安装依赖、配置环境变量并完成第一次 Sub2API 调用的完整步骤指南。

本教程将引导你在 Windows 系统上准备开发环境、配置 Sub2API 密钥与 Base URL，并运行第一次 API 调用。整个过程大约需要 5 到 10 分钟。

<Steps>
  <Step title="准备工具">
    根据你的开发语言选择安装 Python 或 Node.js：

    * **Python**：访问 [python.org](https://www.python.org/downloads/) 下载最新稳定版。安装时勾选 **Add Python to PATH**。
    * **Node.js**：访问 [nodejs.org](https://nodejs.org/) 下载 LTS 版本。
    * **cURL**：Windows 10 及更高版本已内置 curl。在 PowerShell 中输入 `curl --version` 验证。
  </Step>

  <Step title="配置环境变量">
    你需要将 API Key 和 Base URL 写入系统环境变量，让 SDK 自动读取。

    <Tabs>
      <Tab title="图形界面设置">
        1. 按 `Win + S` 搜索 **编辑系统环境变量** 并打开。
        2. 点击 **环境变量** 按钮。
        3. 在 **用户变量** 区域点击 **新建**：
           * 变量名：`OPENAI_API_KEY`
           * 变量值：`YOUR_API_KEY`（替换为你的 Sub2API Key）
        4. 再次点击 **新建**：
           * 变量名：`OPENAI_BASE_URL`
           * 变量值：`https://sub2api.ruilinlu.com`
        5. 点击确定保存，**重启终端** 使变量生效。

        <Note>
          此处可插入系统环境变量设置对话框的截图，以便用户对照操作。
        </Note>
      </Tab>

      <Tab title="PowerShell 设置（当前会话）">
        若只想在当前终端会话中使用，可直接执行：

        ```powershell theme={null}
        $env:OPENAI_API_KEY = "YOUR_API_KEY"
        $env:OPENAI_BASE_URL = "https://sub2api.ruilinlu.com"
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="安装 SDK">
    打开 PowerShell 或 CMD，根据语言安装对应的 SDK：

    <CodeGroup>
      ```bash Python theme={null}
      pip install openai
      ```

      ```bash Node.js theme={null}
      npm install openai
      ```
    </CodeGroup>
  </Step>

  <Step title="第一次调用">
    将下方代码保存为 `test.py`，然后在终端中运行 `python test.py`：

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

    client = OpenAI(
        api_key=os.getenv("OPENAI_API_KEY"),
        base_url=os.getenv("OPENAI_BASE_URL")
    )

    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Hello, Sub2API!"}]
    )

    print(response.choices[0].message.content)
    ```

    如果看到模型返回的内容，说明环境配置成功。
  </Step>
</Steps>

## 常见问题排查

<Accordion title="环境变量设置后仍报错 401 Unauthorized">
  Windows 环境变量修改后需要**重启终端**或**重启系统**才能生效。请确认变量名拼写完全正确（区分大小写），并在 PowerShell 中用 `echo $env:OPENAI_API_KEY` 验证是否已加载。
</Accordion>

<Accordion title="pip 命令无法识别">
  请确认安装 Python 时勾选了 **Add Python to PATH**。若仍无效，可尝试使用 `py -m pip install openai` 替代。
</Accordion>

<Accordion title="curl 返回 SSL 证书错误">
  这通常是系统时间不同步或本地安全软件拦截导致。请校准系统时间，或暂时关闭代理/安全软件后重试。
</Accordion>

<Accordion title="模型返回 404 或 model not found">
  请确认你使用的 model 名称在 Sub2API 支持列表中。可参考 [Model 选择指南](/models/how-to-choose) 查看可用模型。
</Accordion>