入门
在软件里用
不用写代码，就能在你已经在用的软件里用上你的密钥。选好软件、复制设置，就完成了。这里的步骤适用于 GPT 模型。
#1. 选你的软件
聊天和翻译软件
编程工具
自己写代码
#2. 复制设置
Cherry Studio
打开：设置 → 模型服务 → OpenAI
"API Host" 会自动补 /v1/chat/completions。填到 host 或 /v1 为止即可；末尾加 # 可以关掉自动补全。
保护好 API Key
请将密钥保存在环境变量或密钥管理服务中，绝不要把长期密钥放进浏览器代码、截图或代码仓库。
#3. 试一下能不能用
- 在软件里选好模型，发一句简短的话，比如“你好”。
- 有回复就说明连上了，这次调用会出现在控制台 → 用量里。
- 如果软件提示密钥不对，看看它要的地址带不带 /v1。
#MCP 工具
模型连接与 MCP 是两套独立配置
aisplice 负责模型连接，MCP 服务器负责外部工具和数据。在 Codex、Cursor 或其他客户端里分别配置 aisplice 和每个 MCP 服务器。
在 Codex 中，可通过命令行添加远程 MCP Server，也可以把等价配置写入 ~/.codex/config.toml：
Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp
# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"MCP 需要单独认证
aisplice API Key 只用于认证模型请求。MCP 的 OAuth、请求头或环境变量请遵循对应服务商说明，配置完成后重启客户端使其重新加载。
#从 OpenAI SDK 迁移
#两行 diff
对大多数项目而言，这就是整个 PR。协议与 OpenAI 一致，因此流式、工具调用、视觉、结构化输出等下游能力都能用现有代码继续跑。
const client = new OpenAI({- baseURL: "https://api.openai.com/v1",+ baseURL: "https://www.aisplice.store/v1",- apiKey: process.env.OPENAI_API_KEY,+ apiKey: process.env.GATEWAY_API_KEY,});
还是没解决？
把请求 ID 或报错信息发给我们，我们来查。