原生兼容，
把常用 AI 能力接入一个站点

OpenAI Compatible：最通用的接入方式

只要软件支持 Custom OpenAI、OpenAI Compatible 或自定义模型，通常都可以先按这套方法配置。

1. 在工具设置中新增自定义服务商，选择 OpenAI Compatible 或 Custom OpenAI。
2. 填入上面的 Base URL、Key 和模型 ID；接口类型优先选择 Chat Completions。
3. 如果支持“获取模型”，先刷新列表；刷新失败不等于聊天一定失败，可以手动输入模型 ID。
4. 发送“请回复：连接成功”，再到讯算使用记录确认请求。

Claude Cowork

下载 Claude Desktop ↗

Cowork 使用 Claude Desktop 的第三方推理模式接入讯算。先配置 Gateway，再启动 Cowork；只在 Claude Code 终端设置变量，不会自动配置这个桌面应用。

1. 安装并确认设备可用

按当前官方 3P 文档，Cowork 需要 macOS 14+，或 Windows 10 build 19041+ / Windows 11，并具备硬件虚拟化。Windows 使用官方 .msix 包，旧 .exe 安装可能只有聊天功能；Windows 还需启用 Virtual Machine Platform。安装前可运行 官方设备 readiness 检查 ↗。

2. 打开第三方推理配置窗口

1. 启动 Claude Desktop。在 macOS 菜单栏或 Windows 登录页左上角 ☰ 应用菜单中，依次进入 Help → Troubleshooting → Enable Developer Mode。
2. 再打开 Developer → Configure Third-Party Inference…。这里是推理服务配置；设置页中的 MCP / 连接器入口不能替代它。
3. 在左侧 Connection 先选择下表的提供商和凭证。组织托管的设备若窗口只读，应由管理员修改生效配置。

不同桌面版本对 Base URL 前缀的处理可能不同。连接测试最终必须落到讯算的 /v1/messages；若旧版测试实际请求 /messages，按该版窗口提示使用 https://xunsuan.online/v1；若出现 /v1/v1/messages，去掉重复前缀。不要把完整 /v1/messages 端点填进 Base URL。

3. 明确模型，保存并重启

在 Models 中填写当前 Key 支持的完整 Messages 模型 ID，优先使用支持流式响应与工具调用的 Claude 模型。若网关模型发现返回了其他协议的模型，不要全部照单选用；手动模型列表的第一项是默认模型。模型显示名只用于菜单，实际请求仍发送 ID。

{
  "inferenceProvider": "gateway",
  "inferenceCredentialKind": "static",
  "inferenceGatewayBaseUrl": "https://xunsuan.online",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceGatewayApiKey": "<YOUR_API_KEY>",
  "inferenceModels": [
    { "name": "<MESSAGES_MODEL_ID>", "labelOverride": "讯算 · Claude" }
  ]
}

1. 运行窗口提供的连接测试，确认地址、凭证与模型均能工作。
2. 点击 Apply Changes，然后 Save & Restart。重启后选择使用配置好的第三方推理模式。
3. 进入 Cowork 新建任务，核对模型。先选择一个测试文件夹，让它总结一个小文本文件，确认输出与讯算使用记录匹配。

Claude 订阅与讯算 API 是分别计费的使用方式。本章对应官方 Claude Desktop on 3P 的 Gateway 接入流程；可用功能取决于应用版本、设备、组织策略和所选模型。

官方推理配置窗口 ↗ · 官方 Gateway 要求 ↗ · 官方模型列表设置 ↗

OpenCode

OpenCode 的 1.x 与 2.x 使用不同的提供商字段。先确认 opencode --version 或桌面版连接的服务版本，再选择下面的配置分支。

1. 桌面版：使用自定义提供商表单

在带有 Custom provider / 自定义提供商 表单的桌面版中，打开 Settings / 设置 → Providers / 提供商，找到自定义提供商并点击 Connect / 连接。当前官方桌面代码只在连接 v1 服务 时显示此入口；连接 v2 服务或界面没有该项时，使用对应版本的配置文件分支。

保存后确认讯算出现在已连接列表，在设置的模型页检查模型，然后新建会话并选中它。表单默认是 Chat Completions；只有 Responses 的模型应使用下方对应运行时配置。

2. 1.x CLI：连接 Key 并编辑配置

1.x 官方 npm 安装包为 opencode-ai；确认 npm 已可用后执行 npm install -g opencode-ai@1。Windows 可使用官方推荐的 WSL，也可按 1.x 安装文档选择原生方式。已安装的用户先检查版本，避免无意升级后沿用旧字段。

1. 在项目目录启动 opencode，运行 /connect → Other，提供商 ID 填 xunsuan，再输入真实 Key。1.x 会把凭证保存在 ~/.local/share/opencode/auth.json，配置文件无需再放 Key。
2. 编辑项目根目录 opencode.json，或全局 ~/.config/opencode/opencode.json。把下面两处 <MODEL_ID> 换成同一个完整 ID；合并已有 provider，不要覆盖其他设置。项目配置可能覆盖全局同名字段。
3. 重新启动后运行 /models，选择讯算模型；顶层 model 也可指定新会话默认模型。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "xunsuan/<MODEL_ID>",
  "provider": {
    "xunsuan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "讯算",
      "options": { "baseURL": "https://xunsuan.online/v1" },
      "models": { "<MODEL_ID>": { "name": "讯算模型" } }
    }
  }
}

3. 2.x CLI：新字段与服务器环境变量

2.x 官方包为 @opencode/cli；支持 npm 安装的环境可用 npm install -g @opencode/cli，Windows 优先从官方页面选择匹配架构的独立二进制文件。不要把 1.x 的 provider / npm / options 与 2.x 的 providers / package / settings 混在一份配置中。

先编辑项目 opencode.json 或 opencode.jsonc（全局仍在 ~/.config/opencode/）。以下示例用环境变量提供凭证，两个模型占位符仍需替换。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "xunsuan/<MODEL_ID>",
  "providers": {
    "xunsuan": {
      "name": "讯算",
      "env": ["XUNSUAN_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://xunsuan.online/v1" },
      "models": { "<MODEL_ID>": { "name": "讯算模型" } }
    }
  }
}

$env:XUNSUAN_API_KEY = "<YOUR_API_KEY>"
opencode --standalone

export XUNSUAN_API_KEY="<YOUR_API_KEY>"
opencode --standalone

--standalone 用当前终端环境启动独立服务器，便于首次验证。2.x 默认共享后台服务器，已经运行的服务不会因为客户端终端新设了变量就自动获得 Key；桌面版或远程服务器也必须让实际提供推理的服务进程读取凭证。进入后运行 /models 选 xunsuan/<MODEL_ID>。

4. 验证与协议错配

先发“只回复：连接成功。”，核对讯算使用记录中的 Key、模型与接口，再让它解释一个小文件并完成一次工具调用。模型名称显示成功不代表流式与工具链已经通过测试。

1.x 自定义提供商 ↗ · 2.x 自定义提供商 ↗ · 2.x 后台服务与路径 ↗

Cherry Studio

下载安装 Cherry Studio ↗

先添加服务商，再添加并启用模型，最后在聊天里选择它。服务商已保存，不代表当前对话已切换。

1. 配置服务商与模型

1. 准备一把讯算专用 Key，以及该 Key 可以使用的完整模型 ID。日常聊天先选支持 Chat Completions 的模型。
2. 进入 设置 → 模型服务 → New API。如果当前版本提供内置 New API，优先使用这个入口。
3. 把 Key 填入“API 密钥”，把 https://xunsuan.online 填入“API 地址”。New API 会按模型协议补版本与接口路径，不要填写完整 Chat 地址。
4. 获取模型列表；没有目标模型或自动获取失败时，手动添加 <YOUR_MODEL_ID>。模型显示名称和本地分组可以自定，模型 ID 必须与控制台一致。
5. 如果添加模型的窗口有“端点类型”，按该模型真实支持的协议选择：普通聊天使用 OpenAI / Chat，Responses 使用对应 Response 类型，Messages 使用 Anthropic。不要只看模型名字选择协议。
6. 完成“检测”，打开服务商的启用开关，再回到聊天页面选择该服务商下的模型。也可在 设置 → 默认模型 中设置默认聊天模型。

2. 没有 New API 时的自定义入口

进入“模型服务”里的添加服务商 / 自定义提供商，名称填写“讯算”。有分开的 OpenAI 与 Anthropic 地址时，本次 Chat 接入只配置 OpenAI；其他协议按所需模型另配。地址以该版本的请求路径预览为准：

普通 Chat 的最终请求地址应为 https://xunsuan.online/v1/chat/completions，不能出现 /v1/v1。不需要为普通讯算接入添加用于强制路径的 # 后缀。

New API 配置说明 ↗ · 连接与模型常见问题 ↗

GitHub Copilot / VS Code 自定义模型

使用当前版 VS Code 的 Custom Endpoint，把讯算模型加入 Chat。先准备可用 Key、完整模型 ID，以及模型支持的协议、上下文和工具能力。

1. 添加讯算服务商

1. 打开命令面板（Windows / Linux：Ctrl + Shift + P；macOS：⌘ + Shift + P），运行 Chat: Manage Language Models。
2. 点击 Add Models → Custom Endpoint，分组名称填“讯算”；按向导填写显示名称和讯算 Key，协议选择 Chat Completions。
3. 在打开的 chatLanguageModels.json 中填写模型。已有服务商时只合并新的对象，保留其他配置；可从模型管理页右上角文件按钮再次打开此文件。

2. 填写模型配置

下面示例用于支持工具调用的 Chat Completions 模型。替换模型 ID；输入上限 28000、输出上限 4000 只是格式示例，两者之和不得超过实际上下文。示例中的 ${input:xunsuanApiKey} 要改成向导实际生成的 apiKey 输入变量引用；已有的引用应保留，不要用明文 Key 替换它。

[
  {
    "name": "讯算",
    "vendor": "customendpoint",
    "apiKey": "${input:xunsuanApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "<MODEL_ID>",
        "name": "讯算代码模型",
        "url": "https://xunsuan.online/v1/chat/completions",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 28000,
        "maxOutputTokens": 4000
      }
    ]
  }
]

按模型可用协议选择其中一行，不要只改 URL。toolCalling、vision 按真实能力设置；没有工具调用能力的模型不会出现在 Agent 模式的选择器中。

3. 选择模型并验证

1. 保存文件，在 Chat 的模型选择器中选择“讯算代码模型”；未显示时检查模型可见性、JSON 报错，再重启 VS Code。
2. 先发“请只回复：连接成功”，再让它解释一个文件；到讯算使用记录核对实际模型。需要换 Key 时，从模型管理页服务商旁的齿轮更新。

官方配置字段与协议说明 ↗ · 模型配置文件入口说明 ↗

Zed Editor

下载 Zed ↗

1. 打开设置并添加服务商

在命令面板运行 agent: open settings，进入 AI → LLM Providers → Add Provider，选择 OpenAI-compatible，填写名称、API URL、完整模型 ID 和实际上下文。需要直接编辑配置时，运行 zed: open settings file 打开用户 settings.json。

2. settings.json 示例

以下是支持工具调用的 Chat Completions 模型示例；两处 <MODEL_ID> 填同一个 ID。将 agent 与 language_models 合并到已有配置，保留其他设置。32000 和 4000 仅为示例，请按模型实际上下文及输出上限调整。

{
  "agent": {
    "default_model": {
      "provider": "xunsuan",
      "model": "<MODEL_ID>"
    }
  },
  "language_models": {
    "openai_compatible": {
      "xunsuan": {
        "api_url": "https://xunsuan.online/v1",
        "available_models": [
          {
            "name": "<MODEL_ID>",
            "display_name": "讯算代码模型",
            "max_tokens": 32000,
            "max_output_tokens": 4000,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}

provider 必须与 openai_compatible 下的 xunsuan 一致。仅支持 Responses 的模型将 capabilities.chat_completions 改为 false；api_url 仍填到 /v1。图片和工具能力按模型调整。

3. 保存 Key，选择模型

1. 回到 AI → LLM Providers，找到刚添加的服务商并填写讯算 Key。界面保存的 Key 进入系统密钥库，不写入 settings.json。
2. 也可通过 Zed 进程环境变量 XUNSUAN_API_KEY 提供 Key；已有非空环境变量会覆盖界面保存的 Key。修改环境变量后完全退出并重新启动 Zed。
3. 在 Agent 面板的模型选择器选中讯算模型，发送“请只回复：Zed 连接成功”，再做一个文件解释任务，并核对讯算使用记录。

Zed 服务商、Key 与协议说明 ↗ · Zed 设置入口 ↗

Cline

安装 Cline ↗

1. 填写连接参数

安装并打开 Cline 面板，点击齿轮进入设置，在 API Configuration 中配置：

2. 核对 Model Configuration

• Context Window / Max Output Tokens：填写该模型的实际上下文与输出上限，避免客户端误判剩余上下文或截断回答。
• Image Support / Computer Use：仅在模型及接口支持时开启；普通代码任务不需要默认启用所有能力。
• Input / Output Price：只影响客户端成本估算；讯算实际扣费以控制台使用记录为准。

如果开启 Use different models for Plan and Act，分别检查两种模式的服务商、Key 和模型；初次接入可先使用同一配置，避免切换模式后仍走旧服务商。

3. 保存并验证

1. 界面有 Verify 时先检查连接，再点 Done / 保存；回到主面板确认当前 Provider 和 Model。
2. 先在 Plan 模式提问“请解释当前项目 README 的用途”，确认文字响应和讯算使用记录；再切到 Act，用一个小任务验证工具调用。
3. 若只有 Act 失败，检查该模式配置与模型工具能力；401 查 Key，404 查路径，模型不存在则核对完整 ID 和 Key 分组。

Cline 兼容服务字段说明 ↗ · Plan / Act 模型配置 ↗

Chatbox

下载 Chatbox ↗

接入讯算使用自定义 API 配置。桌面、移动与网页版本的表单可能不同，先看字段是 API Host，还是 Base URL。

1. 打开 设置 → 模型提供方 / Settings → Model Provider。选择可编辑 API 主机的 OpenAI 项，或用 Add 添加 OpenAI API compatible 提供方，名称可写“讯算”。
2. 把讯算 Key 填入 API Key。Host + Path 表单按上面的值填写；Path 已默认为 /v1/chat/completions 时可保留。若界面只有标准 Base URL 且只补 Chat 路径，填写 https://xunsuan.online/v1。
3. 有地址预览时，确认最终地址为 https://xunsuan.online/v1/chat/completions。不要在 Host 和 Path 两处重复添加 /v1。
4. 添加至少一个模型，模型 ID 填 <YOUR_MODEL_ID>，普通对话类型选“聊天”。显示名称可自定；上下文和输出上限按模型实际限制填写，不确定时保留默认。图片、推理与工具能力只勾选真实支持的项。
5. 保存提供方和模型，再点击 Check / 检查；如果当前版本在模型编辑窗口提供“测试模型”，也可先测试再保存。模型列表获取失败时手动添加准确 ID。
6. 在默认模型设置或新对话的模型选择器中选中刚添加的模型，发送“请回复 ok”，再到讯算核对使用记录。旧对话可能仍保留原来的模型设置。

{
  "id": "xunsuan.online",
  "name": "讯算",
  "type": "openai",
  "iconUrl": "https://xunsuan.online/docs-img/brand-logo.png",
  "urls": { "website": "https://xunsuan.online" },
  "settings": {
    "apiHost": "https://xunsuan.online",
    "apiPath": "/v1/chat/completions",
    "apiKey": "<YOUR_API_KEY>",
    "models": [
      { "modelId": "<YOUR_MODEL_ID>", "type": "chat" }
    ]
  }
}

模型配置教程 ↗ · JSON 导入格式 ↗

WorkBuddy

下载 WorkBuddy ↗

把讯算添加为自定义模型后，还要在任务页选中它。本节分别说明图形界面和本地配置文件两条路径；先看你安装版本实际提供哪一种入口。

1. 准备模型并确认配置入口

1. 在讯算创建专用 Key，并复制一个支持 Chat Completions 的完整模型 ID。可先按最小请求示例验证。
2. 打开 WorkBuddy，点击左下角头像 → 设置（Settings）→ 模型（Model）。
3. “添加模型”里能选择自定义 / Custom 并编辑 URL：使用下方方式 A；只有内置提供商、无法填写地址，但页面显示“本地配置文件”：使用方式 B。

2. 方式 A：在界面添加讯算

点击添加模型，选择可编辑地址的“自定义 / Custom”。内置厂商预设可能自动填入其他地址，保存前核对 URL。

点击保存，回到新任务，在输入框附近的模型选择器中打开“自定义模型”分组，选择刚添加的讯算模型。测试时明确选中它，避免继续使用内置模式。

3. 方式 B：编辑本地 models.json

适用于设置页指明本地文件、但没有可编辑 URL 的版本。以设置页显示的实际路径为准：例如 Windows 设置页可能显示 %USERPROFILE%\.workbuddy\models.json；若页面显示 ~/.codebuddy/models.json 或其他路径，就编辑它指向的文件。

1. 保存手头任务，完全退出 WorkBuddy（包括托盘进程）。复制原 models.json 留作备份。
2. Windows 按 Win + R，粘贴设置页给出的文件夹路径；使用 VS Code 或文本编辑器打开文件，显示文件扩展名，避免保存成 models.json.txt。
3. 检查最外层结构。如果已有文件以 [ 开头，在数组里追加下面的模型对象，保留原内容，用英文逗号分隔。空文件不能用于判断结构；没有现成模板时先使用界面配置，或按该版本明确提供的文件模板填写。

[
  {
    "id": "<MODEL_ID>",
    "name": "讯算 / <MODEL_ID>",
    "vendor": "讯算",
    "url": "https://xunsuan.online/v1/chat/completions",
    "apiKey": "<YOUR_API_KEY>",
    "supportsToolCall": false,
    "supportsImages": false,
    "supportsReasoning": false
  }
]

{
  "models": [
    {
      "id": "<MODEL_ID>",
      "name": "讯算 / <MODEL_ID>",
      "vendor": "讯算",
      "url": "https://xunsuan.online/v1/chat/completions",
      "apiKey": "<YOUR_API_KEY>",
      "supportsToolCall": false,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ]
}

id 和 apiKey 必须替换；name 改成方便识别的名称。三个能力开关在示例中保守设为 false，这只适合先验证普通对话；确认模型能力后再开启对应开关。若版本提供 maxInputTokens、maxOutputTokens，按模型实际限制填写，不照搬内置模型的窗口数值。

保存为 UTF-8（无 BOM），JSON 中不要放注释、全角标点或尾随逗号。重新启动 WorkBuddy，先到“设置 → 模型”确认条目已出现，再回到任务页选中它。

4. 验证与排错

新建空白任务，发送“请只回复：讯算连接成功”。收到回答后，到讯算使用记录核对该 Key、模型和时间。随后用一份无敏感内容的测试文档验证实际需要的文件读取或工具调用。

官方模型设置与自定义协议说明 ↗

Open WebUI

安装 Open WebUI ↗

Open WebUI 是网页服务。先完成部署并取得管理员权限，再添加讯算连接；服务器自身需要能访问讯算。

1. 管理后台添加连接

1. 进入 Settings → Admin → Connections，找到 Manage OpenAI API Connections，点击 Add Connection / 加号。
2. URL 填 https://xunsuan.online/v1，API Key 填专用调用 Key。不要填完整 /chat/completions 路径。
3. 验证连接并查看模型列表。自动发现通常读取 /v1/models；取不到列表时，在连接的 Model IDs 中逐个输入准确模型 ID，并点击加号加入。
4. 保存连接。Model IDs 可作为允许使用的模型清单；团队只需开放确实可用的模型，不必把全部模型都显示出来。
5. 回到聊天页，从模型选择器选择讯算模型，发送“请回复 ok”，核对讯算使用记录。普通成员看不到模型时，再由管理员检查模型的访问权限。

2. 自部署时用环境变量初始化

部署者也可把下面两项放入部署平台环境变量或 Compose 的 environment 中，替换 Key 占位符后应用到 Open WebUI 服务。已有后台连接时，优先直接在后台修改。

OPENAI_API_BASE_URL=https://xunsuan.online/v1
OPENAI_API_KEY=<YOUR_API_KEY>

兼容服务与手动模型指南 ↗ · 环境变量参考 ↗

CodeBuddy

下载 CodeBuddy IDE ↗

IDE 与 Code CLI 都有自定义模型配置。下面使用明确的 Chat Completions 完整地址，先添加模型，再在当前会话选择它。

1. 找到配置文件

用户级配置：Windows 为 %USERPROFILE%\.codebuddy\models.json，macOS / Linux 为 ~/.codebuddy/models.json。在文本编辑器打开；目录或文件不存在时再创建。项目内也可使用 .codebuddy/models.json，但它的优先级更高。

先备份已有文件，再把模型对象合并进 models 数组。不要直接覆盖已有模型、配置字段或项目设置。

{
  "models": [
    {
      "id": "<MODEL_ID>",
      "name": "讯算 / <MODEL_ID>",
      "vendor": "讯算",
      "url": "https://xunsuan.online/v1/chat/completions",
      "apiKey": "<YOUR_API_KEY>",
      "supportsToolCall": false,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ]
}

2. 替换字段并设置能力

• id：控制台里的完整模型 ID；name：模型下拉框的显示名；vendor：可用“讯算”标识。
• url：保持 https://xunsuan.online/v1/chat/completions。这里是完整接口地址，不能只写根域名或 /v1。
• apiKey：IDE 示例填写真实 Key，不能把环境变量名当作 Key。CLI 支持的环境变量引用方式见下方。
• supportsToolCall、supportsImages、supportsReasoning：按模型实际能力调整。示例先关闭以验证普通问答；使用 Agent 前需要确认工具调用支持并开启相应选项。
• maxInputTokens / maxOutputTokens：可选数字，表示实际输入与输出限制。不要为了避免报错任意写大值。

3. 保存、显示和验证

保存合法 UTF-8 JSON 后，应用会检测文件变化；关闭再打开模型列表，选中“讯算 / 你的模型名”。先发送简短问题，再核对讯算使用记录。未刷新时重开应用。

npm install -g @tencent-ai/codebuddy-code
codebuddy --version

$env:XUNSUAN_API_KEY = "<YOUR_API_KEY>"
codebuddy --model "<MODEL_ID>"

export XUNSUAN_API_KEY="<YOUR_API_KEY>"
codebuddy --model "<MODEL_ID>"

IDE models.json、优先级与列表筛选说明 ↗

Trae / TraeCode

官网下载 ↗

1. 打开自定义模型

进入 Settings / 设置 → Models / 模型 → Add Model / 添加模型，选择 Custom Model / 自定义配置。找不到入口时先更新客户端；不同发行版的菜单名称可能不同。

2. 按下表填写

3. 高级设置与保存

展开 Advanced Settings：上下文和输出上限按实际模型填写；Image Input Support / 多模态 只给视觉模型开启；思考模式、模型系列、采样参数先保留默认。需要调整工具调用轮次时注意，它会影响连续请求量。

1. 点击 Add Model。客户端会检查连接；失败时查看窗口中的错误信息，优先核对 URL 开关、Key 和模型 ID。
2. 在模型管理页启用新模型，回到聊天输入框的模型菜单选中“讯算代码模型”。
3. 先发送“请只回复：连接成功”，再测试一个函数解释或小型代码任务，并在讯算使用记录中核对实际请求。

官方模型字段、高级设置与管理说明 ↗

BotGem

下载 BotGem ↗

使用第三方 OpenAI 兼容服务入口。不同平台或版本可能显示为 Other / OpenAI compatible API，或直接显示 OpenAI API Compatible。

1. 打开 设置 → Service Provider / 服务提供商，新增服务。列表中有 Other 且标注 OpenAI compatible API 时选择它；有独立的 OpenAI API Compatible 时选对应兼容入口。
2. 名称可填“讯算”，API Key 填专用 Key。不要把 Key 填进模型名称或地址。
3. 先看地址字段的示例或请求预览再填地址。API Server 自动补 /v1/chat/completions 的界面填 https://xunsuan.online；标准 Base URL 只补 /chat/completions 的界面才填 https://xunsuan.online/v1。
4. Models / 模型列表填完整模型 ID。自动列表没有目标模型时，用该版本提供的自定义模型输入功能添加 <YOUR_MODEL_ID>。
5. 有“检查连接”按钮时先检查，再保存；只有保存按钮时，保存后直接做短消息测试。最终 Chat 路径应只有一个 /v1。
6. 回到对话页新建会话，选择刚新增的服务与模型，发送“请回复 ok”。在讯算使用记录确认这把 Key 的请求后，再尝试长文本或其他功能。

模型不存在时重新复制准确 ID；认证或权限失败时检查 Key 状态与分组。兼容聊天连接不代表原生生图、语音和所有工具能力都已可用。

兼容服务配置指南 ↗ · 安装与首次对话 ↗

LobeHub / LobeChat

官方产品入口 ↗ · 自部署项目 ↗

先配置 AI 服务商并启用模型，再修改助理或会话的模型。官方云服务、个人 Key 和自部署环境变量是不同入口。

1. 桌面版或可配置的网页界面

1. 进入 设置 → AI 服务商（旧版可能称“语言模型”），选择 OpenAI 服务商并确认启用。已有云订阅模型不会自动替换为讯算。
2. 填写 Key 与 API 代理地址。标准 OpenAI 接入使用 https://xunsuan.online/v1，不是完整 Chat 接口。若某版本明确预览会自动补 /v1，按其预览调整为根地址。
3. 点击“获取模型列表”，找到目标模型并开启其显示开关。获取失败或列表没有目标 ID 时，使用自定义模型入口添加准确 ID；模型能力按实际支持填写。
4. 在“连通性检查”中选择可用模型进行检查。检查失败时同时核对路径、Key 与模型协议，不能只换显示名称。
5. 回到聊天，给当前助理或新会话选择刚启用的模型。版本有“服务模型 / 默认模型”页面时，可设置新建助理与话题命名使用的模型；辅助任务也应选择该 Key 可调用的模型。
6. 新建会话发送“请回复 ok”，到讯算核对使用记录。仍走旧模型时检查当前助理设置和默认模型，而不只是服务商配置。

2. 自部署时设置默认服务商

按所用版本的部署说明，在环境变量中设置 Key、代理地址与自定义模型。以下示例用于 OpenAI 兼容接入；更改部署变量后重新应用部署，再核对界面实际值。

OPENAI_API_KEY=<YOUR_API_KEY>
OPENAI_PROXY_URL=https://xunsuan.online/v1
OPENAI_MODEL_LIST=+<YOUR_MODEL_ID>

官方环境变量与部署说明 ↗

OpenCat

官方下载入口 ↗

接入讯算使用 API 客户端 / BYOK 模式。OpenCat Cloud 是另外的服务，购买或选中 Cloud 模型不会自动使用讯算 Key。

1. 按 Apple 平台下载并打开 OpenCat，准备讯算专用 Key 与完整模型 ID。
2. 进入设置，找到可填写个人 API Key 的 API 客户端 / BYOK 或服务商入口。不同平台的菜单名称可能不同。
3. 确认该版本允许设置自定义 API 地址，再选择 OpenAI 兼容服务；Base URL 填 https://xunsuan.online/v1。若界面拆成服务器与请求路径，按显示的路径拼接规则填写，最终 Chat 地址应为 https://xunsuan.online/v1/chat/completions。
4. 填写 Key，选择或添加完整模型 ID。支持手动模型的版本可在列表无法刷新时手动填写；没有手动输入功能时，不要把显示名称当作模型 ID。
5. 保存后返回聊天，选中个人 API 服务下的模型，新建会话发送“请回复 ok”，并核对讯算使用记录。

API_DOMAIN=https://xunsuan.online

API 客户端与 Cloud 模式说明 ↗ · Team 官方部署说明 ↗

NextChat

官方入口 ↗ · 开源项目与部署说明 ↗

下面按官方开源 NextChat 的 OpenAI 接入规则配置。托管网页是否开放自定义接口由站点决定；它的云账号或访问密码不是讯算 API Key。

1. 网页或客户端中配置

1. 打开可信的 NextChat 实例，进入设置。找到“自定义接口”，启用后把“模型服务商”设为 OpenAI。
2. API Key 填讯算 Key，“接口地址”填 https://xunsuan.online。官方开源 OpenAI 客户端会继续拼 v1/chat/completions，这里不要加 /v1 或完整接口路径。
3. 在“自定义模型名”加入 +<YOUR_MODEL_ID>@OpenAI。多个条目用英文逗号分隔；@OpenAI 指定客户端路由，发送给讯算的模型 ID 仍是占位符替换后的完整名称。
4. 保存设置或确认自动保存完成。新建对话，在模型选择器选中刚添加的模型；已有会话可能有自己的模型设置。
5. 如版本有“对话摘要模型”，也选择该 Key 可以调用的模型，避免主对话成功而自动命名、历史压缩失败。
6. 发送“请回复 ok”，核对讯算使用记录。网页没有自定义接口或管理员已关闭自带 Key 时，需联系该实例管理员或自行部署。

2. 自部署时配置环境变量

在部署平台或 Compose 中设置下面变量，替换占位符后重新应用部署。这是 NextChat 自身的部署配置。

OPENAI_API_KEY=<YOUR_API_KEY>
BASE_URL=https://xunsuan.online
CUSTOM_MODELS=+<YOUR_MODEL_ID>@OpenAI

CUSTOM_MODELS 中 + 添加模型、- 隐藏模型，英文逗号分隔；若只想显示自己的清单，可使用 -all,+<YOUR_MODEL_ID>@OpenAI。API Key 放在部署环境或客户端 Key 字段，不写进公开前端源码。

GitHub 的 Source code 压缩包是源码。是否有可安装桌面包以官方当前发布页为准；网页版不需要把源码包下载到电脑。

官方环境变量说明 ↗ · 官方请求路径与服务商定义 ↗