OPENAI COMPATIBLE

算悟AI · 使用指南

为开发者提供稳定、透明的模型接入服务。从收到 API Key 到编辑器配置,按本页操作即可在主流 AI 编辑器中使用。

目录

01

开始前准备

1
收到 API Key

下单后客服会发送 API Key(格式:sk-xxxxxxxx)。

2
确认有效期

API Key 从创建时开始计时,24 小时内有效,建议收到后尽快配置使用。

3
下载编辑器

确保已安装 Trae、Cursor 或 Windsurf 等支持自定义模型的 AI 编辑器。

⚠️ 请勿将 API Key 发送给陌生人,也不要在公开截图中暴露完整 Key。
02

通用接入参数

所有支持「自定义 OpenAI」或「OpenAI Compatible」的客户端,都可以使用以下参数:

配置项 填写内容
Base URL / API Base https://token.zhizhang.me/v1
API Key sk-xxxxxxxxxxxxxxxx
模型名称 从下方模型列表选择
💡 如客户端要求填写完整接口地址,使用 https://token.zhizhang.me/v1/chat/completions

可用模型

请在编辑器中填写以下任意一个模型名称:

qwen3.8-max-preview
qwen3.7-plus
qwen3.7-max
qwen3.6-flash
deepseek-v4-pro
03

Trae 配置

Trae 支持 Work / CN / Solo 版本,菜单名称可能略有差异,但配置参数相同。

步骤 1:打开模型配置

打开 Trae → 点击左下角设置图标 → 选择「模型」或「AI Model」→ 找到「自定义模型」或「Custom Provider」区域。

步骤 2:关闭自动选择

关闭「AUTO」自动模型选择,滚动到页面底部的自定义配置区域。

步骤 3:填写接入参数

在自定义配置区域添加新模型,填写以下参数:

配置项 填写内容
Base URL https://token.zhizhang.me/v1
API Key sk-xxxxxxxxxxxxxxxx
模型名称 从可用模型列表选择
完整 URL 关闭
多模态 关闭

步骤 4:高级配置(可选)

展开高级配置,可按以下参数填写:

配置项 推荐值
上下文窗口(输入) 128000
最大输出 8192
工具调用轮次 10

步骤 5:保存并测试

保存配置后,重启 Trae,新建会话并切换到已添加的模型,发送一条简短消息验证配置是否成功。

💡 遇到「模型请求失败」时,检查模型名称是否从可用模型列表中完整复制,保存后重启 Trae 并新建会话测试。
04

Cursor 配置

步骤 1:打开设置

打开 Cursor → 点击右上角齿轮图标 → 选择「Settings」→ 左侧选择「Models」。

步骤 2:添加自定义模型

点击「+ Add Model」按钮,在弹出的配置框中选择「OpenAI API Key」类型。

步骤 3:填写接入参数

填写以下参数:

配置项 填写内容
Base URL https://token.zhizhang.me/v1
API Key sk-xxxxxxxxxxxxxxxx
模型名称 从可用模型列表选择

步骤 4:保存并使用

保存配置后,在对话界面选择刚添加的模型即可使用。建议先发一条简短消息验证配置。

05

Windsurf 配置

步骤 1:打开模型设置

打开 Windsurf → 点击左下角设置图标 → 选择「Models」→ 找到「Custom Models」区域。

步骤 2:添加自定义模型

点击「+ Add Custom Model」,选择「OpenAI Compatible」类型。

步骤 3:填写接入参数

填写以下参数:

配置项 填写内容
Base URL https://token.zhizhang.me/v1
API Key sk-xxxxxxxxxxxxxxxx
模型名称 从可用模型列表选择

步骤 4:保存并测试

保存配置后,在 Cascade 面板选择刚添加的模型,发送消息验证配置是否成功。

06

常见问题

API Key 无效 / 401 错误
检查是否使用了客服发送的完整 API Key,没有多余空格或引号。注意 Bearer 后面有一个空格。
模型不存在 / 404 错误
模型名称必须从本页可用模型列表中完整复制,不能自行修改、增加空格或使用其他变体。
请求超时或模型不可用
先检查网络连接。持续异常时,携带报错截图和使用时间联系客服。
24 小时从什么时候开始算?
从 API Key 创建时开始计时,建议收到后尽快使用。
100 次用完了怎么办?
可以再次购买,或联系客服获取更大额度的套餐。
支持流式输出吗?
支持,设置 stream: true 即可使用流式输出。
支持 Function Calling 吗?
支持,具体能力取决于所选模型以及编辑器的兼容性。