客户端接入

所有客户端只需填两个值：基础地址 https://aitokone.com/v1 和你的 API Key。

通用规则：凡是支持「自定义 OpenAI 兼容端点」的客户端，都在设置里找 Base URL / API Base / 接口地址 填 https://aitokone.com/v1， API Key 填你的 sk- 令牌，模型名 从模型列表里挑一个填进去。

一、ChatGPT 桌面版 / Codex

ChatGPT 桌面版内置的 Codex 能力通过 ~/.codex/config.toml 与 ~/.codex/auth.json 两个文件读取配置。

1. 备份原配置

mkdir -p ~/.codex-backup
cp ~/.codex/config.toml ~/.codex-backup/ 2>/dev/null
cp ~/.codex/auth.json  ~/.codex-backup/ 2>/dev/null

2. 写入 config.toml

model = "gpt-5.6-sol"
model_provider = "custom"

[model_providers.custom]
name = "aitokone"
base_url = "https://aitokone.com/v1"
wire_api = "responses"
requires_openai_auth = true

3. 写入 auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-你的密钥"
}

两个最常见的坑：

不要用 env_key = "OPENAI_API_KEY"。这个字段只会去读环境变量，而 GUI 启动的桌面版通常没有任何环境变量，结果是 Missing environment variable。请改用上面的 requires_openai_auth = true + auth.json 写法。
切换第三方网关时，不要保留官方登录态。如果 auth.json 里还留着官方的 OAuth 令牌，请求会被发去官方接口并鉴权失败。切到本站时请确保 auth_mode 为 apikey。

4. 验证

codex exec "回复 GATEWAY OK 四个字"

返回内容正常且控制台「日志」页面出现一条计费记录，即为成功。

如果你同时使用官方账号与本站网关，可以用 CC Switch 这类切换工具在多个供应商预设之间一键切换，它会自动改写上面两个文件，免去手工编辑。

二、Cursor

打开 Settings → Models。
关闭所有 OpenAI 官方模型开关，点击 Add model 手动添加，例如 gpt-5.6-sol。
在 OpenAI API Key 处填入你的 sk- 令牌。
展开 Override OpenAI Base URL，填 https://aitokone.com/v1。
点击 Verify，通过后即可在对话中选用该模型。

三、Cherry Studio

设置 → 模型服务 → 添加提供商，类型选 OpenAI。
API 地址填 https://aitokone.com/v1（注意末尾不要多加 /chat/completions）。
API 密钥填你的 sk- 令牌。
点击「管理」拉取模型列表，勾选需要的模型后保存。

四、其他兼容客户端

以下客户端同样适用「Base URL + API Key」两步配置：

客户端	配置位置
Open WebUI	管理员设置 → 连接 → OpenAI API，填入地址与密钥
LobeChat	设置 → 语言模型 → OpenAI，开启自定义接口地址
NextChat	设置 → 自定义接口，填入地址与密钥
Dify	模型供应商 → OpenAI → 自定义 API Base
沉浸式翻译	翻译服务 → OpenAI → 自定义 API 地址
Obsidian 插件	Copilot / Text Generator 等插件均支持自定义 Base URL

五、代码里直接调用

OpenAI 官方 SDK（Python）

from openai import OpenAI

client = OpenAI(
    base_url="https://aitokone.com/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://aitokone.com/v1",
  apiKey: process.env.AITOKONE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

把密钥放进环境变量，不要硬编码进源码： export AITOKONE_API_KEY="sk-..."