通用接入指南:Chatbox、VS Code 与 SDK
Base URL + API Key + 模型 ID 三要素,附 cURL / Python / Node.js 示例与 Chatbox、NextChat、VS Code 插件配置。
准备三个信息:本站 API 地址、对应分组密钥、该分组支持的模型 ID。不同客户端界面会变化,最终请求路径比输入框名称更可靠。
端点怎么填写
| 用途 | 国际优化线路 | 国内直连专线 |
|---|---|---|
| OpenAI 兼容 Base URL | https://api.sfapi.de/v1 |
https://api-cn.sfapi.de/v1 |
| 只要求主机地址的字段 | https://api.sfapi.de |
https://api-cn.sfapi.de |
客户端若自动追加 /v1,主机字段不重复填写;SDK 的 base_url 通常包含版本前缀。常见最终路径为 /v1/chat/completions 或 /v1/responses,使用哪一种取决于客户端和分组支持。
Chatbox、NextChat、LobeChat 与编辑器插件
在服务商设置中选择 OpenAI 兼容接口或自定义服务商,填写地址、密钥与模型。Cline、Roo Code 等工具还需要模型支持工具调用,不能只检查普通聊天是否成功。
菜单和路径拼接方式随版本变化,请先发送一条短消息,再检查本站使用记录。不要把本站密钥填写到 OpenAI 官方域名对应的配置中。
Continue 配置示例
当前 Continue 使用 config.yaml,旧 config.json 已弃用。备份原配置后按 官方配置参考 合并示例,替换模型和密钥:
name: SuperFast
version: 1.0.0
schema: v1
models:
- name: SuperFast
provider: openai
model: 替换为分组支持的模型ID
apiBase: https://api.sfapi.de/v1
apiKey: 替换为本站密钥
roles:
- chat
- edit
真实密钥不能提交到项目仓库。若客户端支持操作系统凭据管理或环境变量,优先使用对应方式。
Python SDK
安装 openai 包,在运行环境中设置 SUPERFAST_API_KEY 和 SUPERFAST_MODEL。模型需支持本示例的 Chat Completions 协议:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SUPERFAST_API_KEY"],
base_url="https://api.sfapi.de/v1",
)
stream = client.chat.completions.create(
model=os.environ["SUPERFAST_MODEL"],
messages=[{"role": "user", "content": "请简短介绍你能完成的任务。"}],
stream=True,
)
for chunk in stream:
if chunk.choices:
print(chunk.choices[0].delta.content or "", end="", flush=True)
print()
流式用量块可能没有 choices,因此示例先判断非空。不同模型的参数支持范围不同,不默认强制设置 temperature 等参数。
Node.js SDK
安装 openai 包后,在服务端运行环境配置相同的环境变量:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.SUPERFAST_API_KEY,
baseURL: "https://api.sfapi.de/v1",
});
const result = await client.chat.completions.create({
model: process.env.SUPERFAST_MODEL,
messages: [{ role: "user", content: "你好,请简短回复。" }],
});
console.log(result.choices[0]?.message?.content ?? "");
这些 SDK 示例用于服务端或本机脚本,不应带着真实密钥打包进公开网页。
连接成功后
在本站控制台核对请求时间、模型、密钥与费用;先确认小量调用,再开启批量或自动任务。遇到错误请参考 故障排查。
SuperFast AI文档中心