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、费用、耗时与状态;管理员可在后台查看所有请求日志。