Integration Guide
把起源接入你的 AI 工具
本站提供标准 OpenAI 兼容接口。任何支持自定义 Base URL 与 API Key 的 AI 客户端,都可以直接使用。只需替换接口地址和密钥,模型名使用控制台中展示的模型 ID。
API BASE URL
https://your-host/v1
API KEY
sk- 开头的用户密钥
去创建
推荐在工具中填写 https://your-host/v1。部分工具会自动追加 /v1,系统已兼容重复路径,不会导致 404。
ChatGPT NextChat
桌面端与网页端 NextChat 的自定义接口配置方式。
1
打开 设置,找到 自定义接口 / Custom Endpoint 并启用。
2
接口地址 填写 BASE_URL_PLACEHOLDER;如果当前版本会自动追加 /v1/chat/completions,填写站点根地址即可。
3
API Key 填写控制台创建的 sk-... 密钥。
4
在自定义模型列表中添加 MODEL_PLACEHOLDER,保存后选择该模型开始对话。
推荐配置
接口地址:BASE_URL_PLACEHOLDER API Key:sk-YOUR_API_KEY 模型名称:MODEL_PLACEHOLDER 接口协议:OpenAI
如果连接失败,请先确认密钥状态为「正常」、账户余额充足,并检查模型 ID 是否与控制台完全一致。
Cherry Studio
在 Cherry Studio 中添加 OpenAI 兼容模型服务。
1
打开 设置,进入 模型服务,选择 OpenAI 或「添加提供商」。
2
API 地址 填写 BASE_URL_PLACEHOLDER;若版本提示地址需以 /v1 结尾,保留该地址即可。
3
API 密钥 填写控制台创建的密钥,然后点击「检查」或刷新模型列表。
4
在模型列表中启用 MODEL_PLACEHOLDER,回到对话页选择对应模型。
参数填写
提供商类型:OpenAI API 地址:BASE_URL_PLACEHOLDER API 密钥:sk-YOUR_API_KEY 模型 ID:MODEL_PLACEHOLDER
如果模型列表拉取失败,通常是 Base URL 多了或少了 /v1。可尝试填写站点根地址 https://your-host/v1 或去掉末尾的 /v1。
Chatbox
桌面端 Chatbox 的自定义 OpenAI API 配置。
1
进入 设置,选择 模型提供方 / Model Provider,添加 OpenAI API。
2
API Host 填写 BASE_URL_PLACEHOLDER,API Key 填写 sk-...。
3
模型 填写控制台中的模型 ID:MODEL_PLACEHOLDER。保存后即可发送消息。
参数填写
API Host:BASE_URL_PLACEHOLDER API Key:sk-YOUR_API_KEY Model:MODEL_PLACEHOLDER
Cline(VS Code 插件)
在 VS Code 中使用 Cline 调用本站模型。
1
在 VS Code 扩展市场安装 Cline,打开侧边栏设置。
2
API Provider 选择 OpenAI Compatible。
3
Base URL 填写 BASE_URL_PLACEHOLDER,API Key 填写用户密钥。
4
Model ID 填写 MODEL_PLACEHOLDER,保存后即可在代码编辑器中对话。
Cline 配置
Provider:OpenAI Compatible Base URL:BASE_URL_PLACEHOLDER API Key:sk-YOUR_API_KEY Model ID:MODEL_PLACEHOLDER
Continue(VS Code / JetBrains)
通过 Continue 的配置文件添加自定义模型。
1
打开 Continue 设置,编辑 config.json(通常位于 ~/.continue/config.json)。
2
将以下配置加入 models 数组,替换模型 ID 和密钥。
3
保存并重载 Continue,在模型下拉框中选择「起源」。
config.json
{
"models": [
{
"title": "起源",
"provider": "openai",
"model": "MODEL_PLACEHOLDER",
"apiBase": "BASE_URL_PLACEHOLDER",
"apiKey": "sk-YOUR_API_KEY"
}
]
}
Continue 的字段名可能随版本变化,如提示无法识别,请以当前版本的官方配置说明为准。
OpenAI Python SDK
使用官方 openai 包,把 base_url 指向起源即可。
1
安装依赖:pip install openai。
2
将 base_url 设置为 BASE_URL_PLACEHOLDER,模型名使用控制台中的模型 ID。
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-YOUR_API_KEY",
base_url="BASE_URL_PLACEHOLDER",
)
stream = client.chat.completions.create(
model="MODEL_PLACEHOLDER",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
OpenAI Node.js SDK
在 Node.js 项目中通过官方 SDK 调用。
1
安装依赖:npm install openai。
2
创建客户端时传入 apiKey 与 baseURL。
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-YOUR_API_KEY",
baseURL: "BASE_URL_PLACEHOLDER",
});
const response = await client.chat.completions.create({
model: "MODEL_PLACEHOLDER",
messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);
curl 命令行
用于快速验证密钥、地址与模型是否可用。
基础调用
curl BASE_URL_PLACEHOLDER/chat/completions \
-H "Authorization: Bearer sk-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_PLACEHOLDER","messages":[{"role":"user","content":"你好"}],"stream":false}'
查看可用模型
curl BASE_URL_PLACEHOLDER/models \ -H "Authorization: Bearer sk-YOUR_API_KEY"
返回 401 表示密钥无效;402 表示余额不足;404 表示模型不存在或地址错误。
返回 401:API 密钥无效
检查密钥是否复制完整、是否在控制台被停用或删除,以及账号是否正常。密钥只在本站有效,不要填写其他平台的密钥。
返回 404:模型不存在或接口地址错误
模型名必须与控制台展示的模型 ID 完全一致。接口地址建议填写 https://你的域名/v1。系统同时兼容工具自动追加 /v1 的情况。
返回 402:余额不足
在控制台使用兑换码充值,或联系管理员增加余额。每次请求的费用会在调用结束后从余额中扣除。
流式输出卡住或一次性返回
如果通过 Nginx 等反向代理部署,请为本站接口关闭响应缓冲:proxy_buffering off;,并适当增大 proxy_read_timeout。
如何查看每次调用的 Token 与费用
登录用户控制台,在「用量明细」中可以看到时间、模型、输入输出 Token、费用、耗时与状态;管理员可在后台查看所有请求日志。