SuperFast AISuperFast AI文档中心
客户端接入

通用接入指南: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 接口的工具,核心只需配置好以下三要素:

🔑
🔑 核心接入三要素: - API 端点(Base URL):https://api.20020723.xyz/v1(部分客户端如果自带 /v1,则填 https://api.20020723.xyz) - API 密钥(API Key):在 控制台 生成的以 sk- 开头的密钥 - 目标模型(Model):在 官方模型广场 查询并复制的标准模型 ID(如 gpt-6.1-sol、claude-opus-5-5、gemini-3.7-flash 等)

一、桌面对话客户端配置

1. Chatbox AI 客户端

Chatbox 是一款跨平台(Windows / macOS / Linux / iOS / Android)开源客户端:

  1. 打开 Chatbox,点击左下角 「设置」。
  2. AI 提供商:选择 OpenAI API。
  3. API 密钥:粘贴您在本站申请的 sk-... 密钥。
  4. API 域名(API Host):填写 https://api.20020723.xyz(或完整端点 https://api.20020723.xyz/v1)。
  5. 模型:手动输入您想要使用的模型 ID(如 gpt-6-sol、claude-opus-5 等)。
  6. 点击「保存」即可开启对话。

2. NextChat (ChatGPT-Next-Web)

  1. 打开 NextChat 网页版或桌面端,点击左下角 「设置」。
  2. 找到 「模型服务商」 → 「自定义接口」。
  3. 接口地址:填写 https://api.20020723.xyz。
  4. API Key:填写您的 sk-... 密钥。
  5. 自定义模型列表:输入 +gpt-6.1-sol,+claude-opus-5-5,+gemini-3.7-flash,+deepseek-v4.1-flash。
  6. 返回聊天界面,在顶部切换为您需要的模型即可。

3. LobeChat

  1. 打开 LobeChat 设置 → 「语言模型」 → 「OpenAI」。
  2. 开启 OpenAI 服务商开关。
  3. API Key:填入您的 sk-... 密钥。
  4. API 代理地址:填写 https://api.20020723.xyz/v1。
  5. 点击「检查」测试连接,成功后勾选所需模型即可。

二、VS Code 编程插件与智能体配置(Cline / Roo Code / Continue)

💡
💡 优先推荐:如果您需要端到端的深度代码智能体,我们强烈建议使用本站重磅优化的 Codex 桌面端全攻略 或 Claude Code 终端自主编程实战。如果您习惯在 VS Code 编辑器内通过插件工作,可按如下规范配置:

1. Cline / Roo Code 插件配置

Cline 是 VS Code 内非常流行的自主编程智能体插件:

  1. 打开 VS Code,在扩展商店搜索并安装 Cline(或 Roo Code)。
  2. 点击侧边栏 Cline 图标,进入设置(Settings)。
  3. API Provider:选择 OpenAI Compatible。
  4. Base URL:填写 https://api.20020723.xyz/v1。
  5. API Key:填入您的 sk-... 密钥。
  6. Model ID:输入目标模型(如 claude-opus-5-5 或 gpt-6.1-sol)。
  7. 点击保存,即可在 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();

四、常见注意要点

  1. Base URL 后缀:标准格式必须包含 /v1(即 https://api.20020723.xyz/v1),结尾不要有多余的斜杠 /。
  2. Key 对应分组:必须确认您的 API Key 所归属的分组包含了您想调用的模型(例如调 Claude 模型 Key 要绑定 Claude 或全能分组),否则会报 503 错误。
  3. 模型名称查询:请随时访问 官方模型广场 (https://api.20020723.xyz/model-plaza) 获取全网最新的准确模型 ID。
最后更新:2026-11-03模型以官方模型广场为准 ↗
ESC