Windows 上使用 Sub2API 的完整指南

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

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

1. 准备工具

   根据你的开发语言选择安装 Python 或 Node.js：

   • Python：访问 python.org 下载最新稳定版。安装时勾选 Add Python to PATH。
   • Node.js：访问 nodejs.org 下载 LTS 版本。
   • cURL：Windows 10 及更高版本已内置 curl。在 PowerShell 中输入 curl --version 验证。
2. 配置环境变量

   你需要将 API Key 和 Base URL 写入系统环境变量，让 SDK 自动读取。

   图形界面设置

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

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

   PowerShell 设置（当前会话）

   若只想在当前终端会话中使用，可直接执行：

   $env:OPENAI_API_KEY = "YOUR_API_KEY"
   $env:OPENAI_BASE_URL = "https://sub2api.ruilinlu.com"
   
3. 安装 SDK

   打开 PowerShell 或 CMD，根据语言安装对应的 SDK：

   Python

   pip install openai
   
4. 第一次调用

   将下方代码保存为 test.py，然后在终端中运行 python test.py：

   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)
   

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

常见问题排查

环境变量设置后仍报错 401 Unauthorized

Windows 环境变量修改后需要重启终端或重启系统才能生效。请确认变量名拼写完全正确（区分大小写），并在 PowerShell 中用 echo $env:OPENAI_API_KEY 验证是否已加载。

pip 命令无法识别

请确认安装 Python 时勾选了 Add Python to PATH。若仍无效，可尝试使用 py -m pip install openai 替代。

curl 返回 SSL 证书错误

这通常是系统时间不同步或本地安全软件拦截导致。请校准系统时间，或暂时关闭代理/安全软件后重试。

模型返回 404 或 model not found

请确认你使用的 model 名称在 Sub2API 支持列表中。可参考 Model 选择指南 查看可用模型。