[lab.magiconch.com][福音戰士標題生成器]-1781699675177

Token自由计划

本文介绍如何通过自建 API 中转站,统一管理和使用高质量模型 API。主要覆盖三类使用场景:

  • 使用 Cherry Studio 进行多模型对话。
  • 使用 CC Switch 管理 API 配置与模型代理。
  • 在 Codex 或 Claude Code 中接入自建 API 进行编程辅助。

模型与价格:https://api.neonexus.top/pricing

注意:文档中的 NEWAPI_CC_KEY、NEWAPI_CODEX_KEY、NEWAPI_CHERRY_KEY 均为占位符,请统一替换为你在第零节注册账号后自行创建的 API Key。

零、注册账号并获取 API Key

访问以下地址注册账号:

https://api.neonexus.top/

image-20260811114613406

创建 API Key:

image-20260811114709642

创建令牌时,建议根据实际使用场景选择对应的分组:

  • Claude Code:选择 Claude Code 专用分组。
  • Cherry Studio:支持多种接口,可选择 Auto 分组,由系统自动匹配。
  • Codex:仅支持 Responses 接口,因此使用 Codex 时请选择 Codex 专用分组。

分组在创建令牌时选定,之后每个 Key 只走自己的分组,因此建议一个分组建一个 Key:Claude Code、Codex、Cherry Studio 各创建一个令牌,分别对应上面三个分组。这样切换软件时就不用回后台反复改分组,也就是开头提到的 NEWAPI_CC_KEY、NEWAPI_CODEX_KEY、NEWAPI_CHERRY_KEY 三个占位符。

image-20260811131858580

默认令牌分组选 Auto 即可,但模型显示可能不准确:有些模型仅支持 Claude 接口,有些仅支持 OpenAI 接口。如果只是先试试,可以先用 Auto;如果选了某个模型后一直没有回复或者报错,请把使用记录发给管理员:

image-20260811115510027

下文各章节需要填写的 API Key,均在这里自行创建并复制:

image-20260811115819225

一、CC Switch:API 配置管理与代理工具

CC Switch(GitHub 仓库名为 cc-switch,官网 https://ccswitch.io)是 API 配置管理和模型代理的核心工具,建议最先安装。

提示:请安装最新版本的 CC Switch,无需与文档截图中的版本一致。

下载地址:

https://github.com/farion1231/cc-switch/releases

macOS 请选择 macOS.dmg(新版本已合并为通用包,同时支持 Apple 芯片与 Intel;旧版本分为 arm64 与 x86 两个安装包,按机型选择):

image-20260421193127674

Windows 请按架构选择(ARM 机型选 arm64 版):

image-20260421193151129

二、Claude Code 接入(插件与命令行)

1. 安装 Claude Code

Claude Code 可以通过命令行安装,也可以在 VS Code / PyCharm 插件市场中安装插件,推荐使用插件方式。

提示:请安装最新版本的 Claude Code,无需与文档截图中的版本一致。

VS Code 插件安装:

image-20260421192539029

安装完成后不需要登录,保持当前状态即可:

image-20260421222815328

2. 接入配置

目前支持的模型包括:

  • DeepSeek V4 系列模型
  • GLM 系列模型
  • Kimi 系列模型
  • MiniMax 系列模型

2.1 在 CC Switch 中添加供应商

image-20261113221910830

向下滚动,填写以下信息:

供应商名称:NewAPI-cc
API Key:NEWAPI_CC_KEY【替换为你在第零节自行创建的 API Key】
请求地址:https://api.neonexus.top

image-20261113222130179

image-20261113222240596

点击「获取模型列表」:

image-20261113222345765

推荐使用下列模型配置。可先按此处配置,后续再尝试其他喜欢的模型:

image-20261113222550289

向下滑动,下方的配置 JSON 应如下所示:

image-20261113222711107

2.2 重启 VS Code 并开始使用

配置完成后,重新打开 VS Code。看到对应状态后,即可开始使用 Claude Code 进行编码:

image-20261113223654021 image-20261113223621305

三、Codex 接入配置

1. 安装 Codex

提示:请安装最新版本的 Codex,无需与文档截图中的版本一致。

下载地址:

https://openai.com/zh-Hans-CN/codex/

安装 Codex 后,先关闭 Codex:

image-20260421222733327

2. 在 CC Switch 中添加配置

image-20261113223748014

image-20261113223811102

供应商名称:NewAPI codex 专用
API Key:NEWAPI_CODEX_KEY【替换为你在第零节自行创建的 API Key】
API 地址:https://api.neonexus.top/v1

image-20261113224059269

image-20261113224135688

image-20261113224403849

子代理设置推荐使用 DeepSeek:

image-20261113224501665

image-20261113224643120

新版已经支持我们的模型列表:

image-20261113224743779

另外,上下文压缩需要保持开启:

image-20261113224840947

四、Cherry Studio 综合对话配置

1. 添加 API 供应商

打开 Cherry Studio,添加 API 配置:

API 密钥:NEWAPI_CHERRY_KEY【替换为你在第零节自行创建的 API Key】
API 地址:https://api.neonexus.top

搜索 New API:

image-20260903153108473

image-20260905235946918

填写上述信息。

2. 选择模型并添加到对话

选择需要使用的模型:

image-20260421232309140

在右侧添加模型后,即可在对话中使用。

不同厂商的模型添加后可能需要修改端点类型。大部分模型不需要修改,部分模型需要:

  • GPT 系列模型:OpenAI-Response 端点
  • Claude 系列模型:Anthropic 端点
  • Gemini 系列模型:OpenAI 端点
  • Kimi 系列模型:OpenAI 端点
  • GLM 系列模型:Anthropic 端点
  • MiniMax 系列模型:OpenAI 端点
  • MiMo 系列模型:Anthropic 端点
  • DeepSeek 系列模型:Anthropic 端点

说明:各家接口标准不一致,中转站虽然会自动转换,但为了获得完整能力、避免降智,最好按需指定端点类型。

下面举两个例子。添加模型后点击模型设置:

image-20260903135354934

更新模型端点:

image-20260903135517096

Gemini 系列端点修改:

image-20260507163336410

image-20260507163346370

3. 选择生图模型并添加到对话

新增生图模型 GPT-image-2,设置如下:

首先添加生图模型:

image-20261113233626610

然后配置模型链接信息:

image-20260906000827838

填写:https://api.neonexus.top/v1

image-20260906000138456

同时设置默认模型:

image-20261113233752574

使用时需要在工具栏开启生成:

image-20260903150435395

效果:

image-20260903150243761

QA:常见报错及其原因

1. 没有回复、回复慢,或报 500 / 400 错误

status_code=500, not implemented

status_code=400, Error from provider (Console): Upstream request failed: [invalid_request_error] Failed to deserialize the JSON body into the target type: tools[14].function: missing field name at line 1 column 17015

API Key 所属的令牌分组选错了。请到后台查看使用记录,选择与软件匹配的分组:

image-20260811145637249

生成对应分组的令牌即可继续使用:

image-20260811145948939

2. Cherry Studio 报错:端点类型不正确

codex channel: /v1/chat/completions endpoint not supported (request id: 202607150616095162701178268d9d6OnzYLdSu)

这里的报错与上面相反:问题出在 Cherry Studio 的端点类型上。按上文改成对应的端点类型即可解决:

image-20260715141753537

请按上文调整端点类型:GPT 系列模型默认使用 OpenAI-Response 端点。

3. Codex 报错 503:找不到 GPT 模型

这是由于 Codex 的问题导致的。请更新 Codex 和 CC Switch,并按上面的要求设置模型列表,选择我们支持的模型;5.6 目前不支持。

unexpected status 503 Service Unavailable: No available channel for model gpt-5.6-sol under group codex(distributor
7b81e362cd99b1c91ce4043a4cbba13b

4. 报错 502 upstream error

近期网络线路不太稳定,如果频繁出现,请联系管理员切换备用线路,或者先使用国产模型。