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

Codex CLI 配置

OpenAI Codex CLI 是终端中的 AI 编程助手,支持自定义 OpenAI 兼容接口。

步骤 1:安装 Codex CLI

确保已安装 Node.js 18+,然后全局安装:

npm install -g @openai/codex
🇨🇳 国内用户加速安装:如遇网络缓慢或安装失败,使用淘宝镜像源:
npm install -g @openai/codex --registry=https://registry.npmmirror.com --@openai:registry=https://registry.npmmirror.com

长期使用国内源可执行:npm config set registry https://registry.npmmirror.com

步骤 2:设置环境变量

在终端中设置 API Key 和 Base URL(或写入 ~/.zshrc / ~/.bashrc):

export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://token.zhizhang.me/v1"
💡 也可以在项目根目录创建 .env 文件,Codex 会自动加载:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://token.zhizhang.me/v1

步骤 3:配置文件(可选)

编辑 ~/.codex/config.toml,添加自定义 Provider 配置:

model = "qwen3.7-max"
model_provider = "zhizhang"

[model_providers.zhizhang]
name = "算悟AI"
base_url = "https://token.zhizhang.me/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

步骤 4:运行 Codex

交互模式:

codex

带提示词运行:

codex "解释这段代码的作用"

全自动模式(跳过确认):

codex --approval-mode full-auto "创建一个 todo-list 应用"

步骤 5:指定模型(可选)

运行时通过参数切换模型:

codex --model qwen3.7-plus "你的提示词"
⚠️ Codex CLI v0.145.0+ 使用 wire_api = "responses"(OpenAI Responses API),请确保在 config.toml 中正确配置。如遇模型兼容性问题,可尝试切换模型版本。
07

常见问题

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