客户端接入
通用接入指南:Chatbox、VS Code 与 SDK
Base URL + API Key + 模型 ID 三要素,附 cURL / Python / Node.js 示例与 Chatbox、NextChat、VS Code 插件配置。
本指南为您汇集常见客户端(Chatbox、NextChat、LobeChat、VS Code 扩展)及标准开发 SDK(Python / Node.js / cURL)接入 SuperFast API 的通用标准规范。
无论您使用的是哪一款支持自定义 OpenAI 接口的工具,核心只需配置好以下三要素:
一、桌面对话客户端配置
1. Chatbox AI 客户端
Chatbox 是一款跨平台(Windows / macOS / Linux / iOS / Android)开源客户端:
- 打开 Chatbox,点击左下角 「设置」。
- AI 提供商:选择
OpenAI API。 - API 密钥:粘贴您在本站申请的
sk-...密钥。 - API 域名(API Host):填写
https://api.20020723.xyz(或完整端点https://api.20020723.xyz/v1)。 - 模型:手动输入您想要使用的模型 ID(如
gpt-6-sol、claude-opus-5等)。 - 点击「保存」即可开启对话。
2. NextChat (ChatGPT-Next-Web)
- 打开 NextChat 网页版或桌面端,点击左下角 「设置」。
- 找到 「模型服务商」 → 「自定义接口」。
- 接口地址:填写
https://api.20020723.xyz。 - API Key:填写您的
sk-...密钥。 - 自定义模型列表:输入
+gpt-6.1-sol,+claude-opus-5-5,+gemini-3.7-flash,+deepseek-v4.1-flash。 - 返回聊天界面,在顶部切换为您需要的模型即可。
3. LobeChat
- 打开 LobeChat 设置 → 「语言模型」 → 「OpenAI」。
- 开启 OpenAI 服务商开关。
- API Key:填入您的
sk-...密钥。 - API 代理地址:填写
https://api.20020723.xyz/v1。 - 点击「检查」测试连接,成功后勾选所需模型即可。
二、VS Code 编程插件与智能体配置(Cline / Roo Code / Continue)
💡 优先推荐:如果您需要端到端的深度代码智能体,我们强烈建议使用本站重磅优化的 Codex 桌面端全攻略 或 Claude Code 终端自主编程实战。如果您习惯在 VS Code 编辑器内通过插件工作,可按如下规范配置:
1. Cline / Roo Code 插件配置
Cline 是 VS Code 内非常流行的自主编程智能体插件:
- 打开 VS Code,在扩展商店搜索并安装 Cline(或 Roo Code)。
- 点击侧边栏 Cline 图标,进入设置(Settings)。
- API Provider:选择
OpenAI Compatible。 - Base URL:填写
https://api.20020723.xyz/v1。 - API Key:填入您的
sk-...密钥。 - Model ID:输入目标模型(如
claude-opus-5-5或gpt-6.1-sol)。 - 点击保存,即可在 VS Code 侧边栏与智能体协同编写代码并自动运行测试。
2. Continue 插件配置
编辑本地 ~/.continue/config.json 配置文件:
json
{
"models": [
{
"title": "SuperFast - Claude Opus 5.5",
"provider": "openai",
"model": "claude-opus-5-5",
"apiKey": "sk-your-superfast-key",
"apiBase": "https://api.20020723.xyz/v1"
},
{
"title": "SuperFast - GPT-6.1 Sol",
"provider": "openai",
"model": "gpt-6.1-sol",
"apiKey": "sk-your-superfast-key",
"apiBase": "https://api.20020723.xyz/v1"
}
]
}
三、代码开发集成示例(Python / Node.js / cURL)
1. cURL 极速命令行测试
在终端中执行以下命令,测试连接是否畅通:
bash
curl https://api.20020723.xyz/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{"role": "user", "content": "你好,请写一句简短的自我介绍。"}
],
"temperature": 0.7
}'
2. Python (openai-python SDK)
使用官方标准的 openai 库即可无缝对接:
python
import os
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key-here", # 或从 os.environ.get("SUPERFAST_API_KEY") 读取
base_url="https://api.20020723.xyz/v1"
)
response = client.chat.completions.create(
model="gpt-6.1-sol", # 可在模型广场中查询更多模型
messages=[
{"role": "system", "content": "你是一位优秀的专业助手。"},
{"role": "user", "content": "请用三句话解释量子计算的核心思想。"}
],
temperature=0.6,
stream=True
)
for chunk in response:
content = chunk.choices[0].delta.content or ""
print(content, end="", flush=True)
print()
3. Node.js (JavaScript / TypeScript)
使用 Node.js 官方 openai 包:
javascript
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: "sk-your-api-key-here",
baseURL: "https://api.20020723.xyz/v1",
});
async function main() {
const completion = await openai.chat.completions.create({
model: "claude-opus-5-5",
messages: [
{ role: "user", content: "请用 TypeScript 写一个防抖函数(debounce)。" },
],
});
console.log(completion.choices[0].message.content);
}
main();
四、常见注意要点
- Base URL 后缀:标准格式必须包含
/v1(即https://api.20020723.xyz/v1),结尾不要有多余的斜杠/。 - Key 对应分组:必须确认您的 API Key 所归属的分组包含了您想调用的模型(例如调 Claude 模型 Key 要绑定 Claude 或全能分组),否则会报 503 错误。
- 模型名称查询:请随时访问 官方模型广场 (https://api.20020723.xyz/model-plaza) 获取全网最新的准确模型 ID。
最后更新:2026-11-03模型以官方模型广场为准 ↗
SuperFast AI文档中心