本站 API 中转接入文档：Codex、Hermes、Cherry Studio、Chatbox

本文说明如何使用本站 API Key，把 Codex CLI、Hermes Agent、VS Code Codex 插件、CC Switch、Cherry Studio、Chatbox 以及其他第三方 OpenAI 兼容工具接入本站中转。

• 站点首页：https://newapi.jaycue.tech
• API Base URL：https://newapi.jaycue.tech/v1
• API Key 格式：sk-你的令牌

1. 准备工作

• 注册并登录：https://newapi.jaycue.tech
• 账号需要有可用额度；如有兑换码，可到「钱包管理」→「额度兑换」使用。
• 模型名以本站「模型广场」或令牌页面展示为准，例如 gpt-5.4。

2. 创建 API 令牌

1. 打开并登录 https://newapi.jaycue.tech。
2. 进入「控制台」→「令牌」。
3. 点击「添加令牌」，按需设置额度、模型限制、过期时间等。
4. 创建后复制令牌，填写到客户端时通常写成 sk-你的令牌。
5. 如页面提供「填入 Cherry Studio」或其他快捷入口，可以直接点击一键导入。

请勿把 API Key 发给他人。令牌泄露后，别人可以消耗你的额度。

3. 通用填写规则

大部分 OpenAI 兼容客户端只需要三项：地址、Key、模型名。

4. Cherry Studio 接入

新版 Cherry Studio 已内置支持 NewAPI，不需要再新增 OpenAI 兼容供应商，直接选择 NewAPI 类型即可。

推荐配置步骤

1. 打开 Cherry Studio，进入「设置」或「模型服务 / Providers」。
2. 在提供商列表中选择 NewAPI。
3. API 地址 / Base URL 填写 https://newapi.jaycue.tech。如果版本要求填写完整 API Base URL，则填写 https://newapi.jaycue.tech/v1。
4. API Key 填写 sk-你的令牌。
5. 点击「获取模型 / Fetch Models」同步模型列表；如果未自动出现模型，就手动填写本站可用模型名。
6. 保存后，新建聊天，选择 NewAPI 提供商和模型，发送一句测试消息。

旧版 Cherry Studio 如果没有 NewAPI 选项，可以升级 Cherry Studio；暂时不升级时，再使用 OpenAI Compatible / OpenAI 兼容方式手动配置。

5. Chatbox 接入

Chatbox 的不同版本字段名称可能略有差异，核心仍是选择 OpenAI 兼容、自定义地址、填入 API Key 和模型名。

1. 打开 Chatbox，进入「设置」→「模型提供方 / Model Provider」。
2. 选择 OpenAI API 或 OpenAI Compatible / 自定义模型提供方。
3. API Key 填写 sk-你的令牌。
4. 如果字段叫 API Host，优先填写 https://newapi.jaycue.tech；如果字段叫 Base URL / API Base URL，填写 https://newapi.jaycue.tech/v1。
5. 模型名填写本站可用模型，例如 gpt-5.4。
6. 保存后点击测试，或新建对话发送消息。

如果错误信息里出现 /v1/v1，说明客户端自动加了 /v1，请把地址改成根域名 https://newapi.jaycue.tech；如果出现 404 或路径不存在，请尝试带 /v1 的地址。

6. Codex CLI 接入

安装 Node.js 与 Codex CLI

npm install -g @openai/codex
codex --version

创建配置目录

# macOS / Linux
mkdir -p ~/.codex

# Windows PowerShell
mkdir $env:USERPROFILE\.codex

创建 config.toml

路径：macOS / Linux 为 ~/.codex/config.toml，Windows 为 C:\Users\你的用户名\.codex\config.toml。

model_provider = "custom"
model = "gpt-5.4"
review_model = "gpt-5.4"
responses_store = false
network_access = true
web_search = "live"
model_reasoning_effort = "xhigh"
service_tier = "fast"

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://newapi.jaycue.tech/v1"

创建 auth.json

{
  "apiKey": "sk-你的令牌"
}

启动 Codex

cd your-project
codex

示例模型名仅供参考。若提示模型不可用，请改成本站模型广场或令牌页面中实际可用的模型。

7. VS Code 与 CC Switch

VS Code Codex 插件

1. 打开 VS Code 插件市场，安装 Codex 插件。
2. 插件通常会读取本机 ~/.codex/config.toml 和 ~/.codex/auth.json。
3. 如果插件提示缺少配置，请检查文件路径和 JSON/TOML 格式。

CC Switch 一键管理配置

1. 安装并打开 CC Switch。
2. 登录本站，进入「令牌」页面。
3. 找到令牌，点击「填入 CC Switch」。
4. 应用选择 Codex，模型选择本站可用模型。
5. 在 CC Switch 中确认导入并启用。

8. Hermes Agent 接入

Hermes Agent 支持自定义 OpenAI 兼容端点。接入本站中转时，把 Provider 选择为 Custom endpoint，Base URL 填 https://newapi.jaycue.tech/v1，API Key 填本站令牌。

Windows PowerShell 安装

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

如果安全策略阻止脚本执行，请以用户身份调整 PowerShell 执行策略后再运行，或改用 WSL2 方式。

macOS / Linux / WSL2 / Termux 安装

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，重新加载 shell 配置并启动：

source ~/.bashrc    # 或 source ~/.zshrc
hermes

通过交互向导接入本站中转（推荐）

1. 在终端运行 hermes model。
2. 选择 Custom endpoint (self-hosted / VLLM / etc.)。
3. API base URL 填写 https://newapi.jaycue.tech/v1。
4. API key 填写 sk-你的令牌。
5. Model name 填写本站可用模型，例如 gpt-5.4。
6. 保存后运行 hermes，发送一句测试消息。

hermes model
# 选择 Custom endpoint
# Base URL: https://newapi.jaycue.tech/v1
# API Key: sk-你的令牌
# Model: gpt-5.4
hermes

手动配置 config.yaml

也可以直接编辑 ~/.hermes/config.yaml：

model:
  default: gpt-5.4
  provider: custom
  base_url: https://newapi.jaycue.tech/v1
  api_key: sk-你的令牌

验证方式：Hermes 能正常回复，且本站控制台能看到令牌调用记录，即表示 Hermes 已成功接入本站中转。

参考：

• https://github.com/NousResearch/hermes-agent
• https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• https://hermes-agent.nousresearch.com/docs/integrations/providers

9. 其他 OpenAI 兼容客户端

LobeChat、Open WebUI、沉浸式翻译、AI as Workspace、OpenCat 等客户端一般都按下面填写：

10. 常见问题

Q1：提示 401 / invalid api key 怎么办？

• 确认 Key 是否以 sk- 开头。
• 确认没有多复制空格或换行。
• 回到本站「令牌」页面确认令牌未禁用、未删除。

Q2：提示 model not found / 模型不存在怎么办？

把客户端中的模型名改成本站可用模型名。注意大小写、横线和点号要完全一致。

Q3：请求地址到底要不要带 /v1？

字段名是 Base URL / API Base URL 时，通常填 https://newapi.jaycue.tech/v1；字段名是 API Host / Server 且客户端默认示例不带 /v1 时，先填 https://newapi.jaycue.tech。

Q4：如何确认请求已经走本站？

登录本站控制台查看令牌使用记录、额度消耗和日志。

Q5：额度不足怎么办？

进入「钱包管理」充值或使用兑换码兑换额度。

总结：最关键的是 API 地址、API Key、模型名。Key 使用本站令牌，模型名按本站可用模型填写；如果地址报错，就重点检查是否重复或缺少 /v1。