Windows 上使用 Sub2API 的完整指南

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

准备工具

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

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

配置环境变量

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

图形界面设置
PowerShell 设置（当前会话）

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

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

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

$env:OPENAI_API_KEY = "YOUR_API_KEY"
$env:OPENAI_BASE_URL = "https://sub2api.ruilinlu.com"

安装 SDK

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

pip install openai

npm install openai

第一次调用

将下方代码保存为 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 选择指南查看可用模型。

新手引导

配置接入

客户端集成

模型说明

计费与用量

教程

Windows 上使用 Sub2API 的完整指南

常见问题排查

​常见问题排查

常见问题排查