NNYY API 新手详细使用教程
本教程面向第一次使用第三方 API 中转站的新手用户。你不需要有编程经验,只要按步骤操作,就可以完成购买套餐、兑换卡密、创建 API Key、配置客户端,并完成第一次接口调用。
▸ 0. 先看懂整个流程
在开始之前,请先记住 NNYY 的三个常用地址和它们的分工:
| 地址 | 用途 | 新手理解 |
|---|---|---|
https://nnyyai.com |
购买套餐、获取卡密 | 相当于“买充值卡”的地方 |
https://api.nnyyai.com |
登录 API 平台、兑换余额、创建 API Key | 相当于“账户后台” |
https://api.nnyyai.com/v1 |
OpenAI 兼容接口地址 | 填到客户端里的 Base URL |
完整流程如下:
- 在
https://nnyyai.com购买套餐。 - 获取卡密或兑换码。
- 打开
https://api.nnyyai.com并登录。 - 把卡密兑换成 API 平台余额。
- 在 API 平台创建 API Key。
- 把 API Key 和接口地址填入客户端。
- 发送测试请求,确认可以正常使用。
请特别注意:卡密不是 API Key。
卡密只能用于兑换余额。真正给客户端、脚本、Claude Code、Codex、Cursor、Cherry Studio、NextChat 等工具使用的是你在 API 平台里创建的 API Key。
▸ 快速入口
Windows 系统接入导航(点击展开后直达对应教程)
- Claude Code Windows 接入教程
- Codex Windows 接入教程
- Cursor Windows 接入教程
- Cherry Studio Windows 接入教程
- NextChat Windows 接入教程
- Open WebUI Windows 接入教程
- OpenClaw Windows 接入教程
Windows 文档里如果出现:
setx 变量名 "变量值"
这就是 长期环境变量 的写法。设置一次后,电脑重启后也还在,不需要每次重设。
你只需要在设置完成后,关闭并重新打开终端、Claude Code、Codex 或其他客户端,让新环境变量生效。
macOS 系统接入导航(点击展开后直达对应教程)
- Claude Code macOS 接入教程
- Codex macOS 接入教程
- Cursor macOS 接入教程
- Cherry Studio macOS 接入教程
- NextChat macOS 接入教程
- Open WebUI macOS 接入教程
- OpenClaw macOS 接入教程
macOS 如果你把环境变量写进:
~/.zshrc
或:
~/.bashrc
那它也是 长期保存 的。以后重启终端或重启电脑后依然有效。
不会找配置文件时,先按这个思路操作
很多新手卡住,不是因为不会填 URL 和 API Key,而是不知道文件到底在哪。你可以先记住这 4 条:
Claude Code主要改的是终端启动文件,macOS 常见是~/.zshrc或~/.bashrc;Windows 一般不改文本文件,而是写入用户环境变量。Codex主要改的是本地配置文件:macOS 是~/.codex/config.toml,Windows 是%USERPROFILE%\.codex\config.toml。NextChat、Open WebUI、OpenClaw这类自建项目,常见是改项目目录里的.env、.env.example、docker-compose.yml或compose.yml。- 如果你不知道自己该改哪个文件,优先回到本文对应客户端小节,直接照那一节的完整命令执行,不要一上来全盘乱搜。
macOS 可以先执行:
echo $SHELL
pwd
ls -la ~ | grep -E '\.zshrc|\.bashrc|\.codex'
用途:
echo $SHELL:看你当前更可能用zsh还是bashpwd:看你当前终端正在哪个目录ls -la ~:看你的家目录里有没有~/.zshrc、~/.bashrc、~/.codex
Windows PowerShell 可以先执行:
echo $env:USERPROFILE
Get-Location
Get-ChildItem $env:USERPROFILE -Force
用途:
echo $env:USERPROFILE:看你的用户目录在哪里Get-Location:看你当前 PowerShell 正在哪个目录Get-ChildItem $env:USERPROFILE -Force:看用户目录下有没有.codex等隐藏目录
请特别注意:Windows 里如果文档让你执行:
setx 变量名 "变量值"
这不是在修改某个文本文件,而是在写入 Windows 用户环境变量。
你不需要去找一个叫“环境变量配置文件”的东西。设置完成后,关闭并重新打开 PowerShell、Codex、Claude Code 或其他客户端即可。
▸ 1. 准备工作
开始前,你需要准备以下内容:
- 一个可以正常访问网页的浏览器,例如 Chrome、Edge、Safari。
- 一个可以接收登录验证信息的邮箱或账号。
- 已购买的 NNYY 套餐卡密。
- 需要接入的客户端或工具,例如 Claude Code、Codex、Cursor、Cherry Studio、NextChat、Open WebUI、OpenClaw 等。
如果你只是想先测试接口是否能用,可以先不安装复杂客户端,直接使用终端里的 curl 命令测试。
▸ 2. 购买套餐并获取卡密
▸ 1.1 打开套餐购买页面
打开浏览器,访问:
https://nnyyai.com
在页面中选择适合自己的套餐,然后按页面提示完成购买。
▸ 1.2 找到卡密或兑换码
购买完成后,你通常会得到一串卡密或兑换码。
卡密可能出现在以下位置之一:
- 购买成功页面
- 订单详情页面
- 邮箱通知
- 用户中心
- 客服或系统消息
卡密通常是一串较长的字符。请完整复制,不要漏掉前后字符,也不要额外复制空格、换行或中文标点。
▸ 1.3 卡密和 API Key 的区别
很多新手会把卡密直接填到客户端里,这是错误的。
| 类型 | 用途 | 填在哪里 |
|---|---|---|
| 卡密 / 兑换码 | 兑换 API 平台余额 | 填到 api.nnyyai.com 的兑换入口 |
| API Key | 调用模型接口 | 填到 Claude Code、Codex、Cursor、Cherry Studio 等客户端 |
简单理解:
- 卡密 = 充值码
- API Key = 调用接口的密码
你需要先用卡密充值,再创建 API Key。
▸ 3. 登录 API 平台并兑换卡密
▸ 2.1 打开 API 平台
访问:
https://api.nnyyai.com
登录你的账号。如果你还没有账号,请按页面提示注册。
▸ 2.2 找到兑换入口
登录后,在控制台或侧边栏中寻找类似下面的入口:
- 兑换码
- 卡密兑换
- 充值兑换
- 充值
- 钱包
- 余额
不同版本后台的入口名称可能略有不同,但核心操作都是:把购买到的卡密兑换成账户余额。
▸ 2.3 输入卡密并兑换
操作步骤:
- 复制你购买后获得的卡密。
- 粘贴到兑换输入框中。
- 检查是否多复制了空格或换行。
- 点击兑换、确认或提交。
- 等待系统提示兑换成功。
▸ 2.4 确认余额是否到账
兑换完成后,请回到账户余额、钱包或用量页面,确认余额已经增加。
如果余额没有变化,请检查:
- 是否登录了正确账号。
- 卡密是否已经被使用过。
- 卡密是否复制完整。
- 是否兑换到了其他账户。
- 页面是否需要刷新。
只有账户里有可用余额,后续调用 API 才能正常扣费使用。
▸ 4. 创建 API Key
▸ 3.1 进入令牌管理页面
在 https://api.nnyyai.com 控制台中,寻找类似入口:
- 令牌
- API Key
- 访问密钥
- Token
- Keys
进入后,点击创建新令牌、新建 Key 或生成 API Key。
▸ 3.2 推荐的新手配置
创建 API Key 时,可能会看到以下选项。
名称
用于区分这个 Key 是给哪个工具使用的。
推荐命名:
claude-code
codex
cursor
cherry-studio
nextchat
open-webui
建议每个客户端单独创建一个 Key。这样以后某个工具不用了,可以单独删除对应 Key,不影响其他工具。
过期时间
新手测试阶段可以先不设置,方便排查问题。
正式长期使用时,建议设置合理的过期时间,降低密钥泄露风险。
模型权限
如果后台支持模型权限设置,只勾选你需要使用的模型。
例如:
- 只使用 OpenAI 兼容模型,就勾选对应 OpenAI 模型。
- 只给 Claude Code 使用,就勾选 Claude Code 需要的模型。
- 不确定时,可以先按平台推荐配置。
IP 限制
新手一般不建议开启。
只有在你明确知道自己有固定出口 IP 时,再开启 IP 限制。否则你换网络、换电脑、换宽带后,可能会出现接口无法调用的问题。
▸ 3.3 保存 API Key
创建完成后,系统会显示一串类似下面的密钥:
sk-xxxxxxxxxxxxxxxxxxxxxxxx
请立即复制并保存到安全的位置。
重要提醒:
- 不要发给陌生人。
- 不要截图发到公开群。
- 不要写进公开 GitHub 仓库。
- 不要放到网页前端代码里。
- 如果怀疑泄露,请立即删除旧 Key 并重新创建。
很多平台只会在创建时完整显示一次 API Key,关闭页面后可能无法再次查看完整内容。
▸ 5. 选择正确的接口地址
不同工具需要填写的地址可能不同。
▸ 4.1 OpenAI 兼容客户端
大多数客户端使用这个地址:
https://api.nnyyai.com/v1
常见客户端包括:
- Cursor
- Cherry Studio
- NextChat
- Open WebUI
- LobeChat
- ChatBox
- 自己写的 OpenAI SDK 脚本
- 其他支持 OpenAI Compatible API 的工具
这些客户端里一般会有类似字段:
Base URL
API Base URL
OpenAI API Base
Endpoint
接口地址
这些地方通常填写:
https://api.nnyyai.com/v1
大多数 OpenAI 兼容客户端,接入时先填写 Base URL 和 API Key 就够了。
模型通常会在以下位置再选择:
- 客户端的模型下拉框
- 新建对话时选择模型
- 保存服务商后手动添加模型
如果某个客户端或项目模板强制要求你额外填写模型字段,再填写 NNYY 平台当前真实开放的模型名。
▸ 4.2 Claude Code
Claude Code 如果走 Anthropic Messages 兼容接口,通常使用根地址:
https://api.nnyyai.com
注意:Claude Code 这里不要额外添加 /v1。
错误示例:
https://api.nnyyai.com/v1
正确示例:
https://api.nnyyai.com
▸ 4.3 如何判断自己该填哪个地址
| 使用场景 | 推荐地址 |
|---|---|
| OpenAI SDK | https://api.nnyyai.com/v1 |
| Cursor | https://api.nnyyai.com/v1 |
| Cherry Studio | https://api.nnyyai.com/v1 |
| NextChat | https://api.nnyyai.com/v1 |
| Open WebUI | https://api.nnyyai.com/v1 |
| Codex | https://api.nnyyai.com/v1 |
| Claude Code | https://api.nnyyai.com |
▸ 6. 第一次连通性测试
在配置客户端前,建议先测试 API Key 和接口地址是否可用。
▸ 5.1 macOS / Linux 测试方法
打开终端,执行下面命令。
请把下面所有 这里填写你的 API Key 替换成你在 api.nnyyai.com 创建的真实 API Key。
curl https://api.nnyyai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 这里填写你的 API Key" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "你好,请回复一句:NNYY 接口连接成功。"}
]
}'
如果返回内容里出现模型回复,说明接口已经连通。
▸ 5.2 Windows PowerShell 测试方法
Windows 用户可以打开 PowerShell,执行:
$headers = @{
"Content-Type" = "application/json"
"Authorization" = "Bearer 这里填写你的 API Key"
}
$body = @{
model = "gpt-4o-mini"
messages = @(
@{
role = "user"
content = "你好,请回复一句:NNYY 接口连接成功。"
}
)
} | ConvertTo-Json -Depth 5
Invoke-RestMethod `
-Uri "https://api.nnyyai.com/v1/chat/completions" `
-Method Post `
-Headers $headers `
-Body $body
如果返回正常回复,说明 API Key、余额、模型权限和接口地址基本都没有问题。
▸ 5.3 如果测试失败怎么办
请优先检查以下四项:
- API Key 是否完整复制。
Authorization前面是否有Bearer。- Base URL 是否写成了
https://api.nnyyai.com/v1。 - 模型名是否是平台真实开放的模型名。
▸ 7. 接入 Claude Code
本节适合想在 Claude Code 中使用 NNYY API 的用户。
系统导航:macOS 用户先看 6.1,Windows 用户先看 6.2。
▸ 6.1 macOS 接入教程
先安装并确认版本:
curl -fsSL https://claude.ai/install.sh | bash
claude --version
如果你更习惯 npm,也可以执行:
npm install -g @anthropic-ai/claude-code
claude --version
如果你不知道自己该改 ~/.zshrc 还是 ~/.bashrc,先执行:
echo $SHELL
如果输出里有 zsh,优先改:
~/.zshrc
如果输出里有 bash,优先改:
~/.bashrc
如果你只是想先临时测试一次,可以先直接执行:
export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
如果你想长期保存,并且你是 zsh,按下面顺序一步一步执行:
touch ~/.zshrc
ls -la ~/.zshrc
nano ~/.zshrc
打开后,把下面 3 行粘贴进去:
export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
在 nano 里保存的方法是:
- 按
Ctrl + O - 按回车确认保存
- 按
Ctrl + X退出
退出后执行:
source ~/.zshrc
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
如果你使用 bash,按下面顺序执行:
touch ~/.bashrc
ls -la ~/.bashrc
nano ~/.bashrc
把下面 3 行粘贴进去:
export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
保存退出后执行:
source ~/.bashrc
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
▸ 6.2 Windows 接入教程
先安装并确认版本:
irm https://claude.ai/install.ps1 | iex
claude --version
Windows 下 Claude Code 一般不需要你去找某个文本配置文件。最稳的做法是直接把配置写进用户环境变量。
先执行下面这组命令写入长期配置:
setx ANTHROPIC_BASE_URL "https://api.nnyyai.com"
setx ANTHROPIC_AUTH_TOKEN "这里填写你的 API Key"
setx CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY "1"
然后立刻检查“是否已经写进用户环境变量”:
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL","User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY","User")
如果你能看到刚才设置的值,说明已经保存成功。
接着,关闭当前 PowerShell 和 Claude Code,再重新打开。
重新打开后验证:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
▸ 6.3 通用说明
| 环境变量 | 含义 |
|---|---|
ANTHROPIC_BASE_URL |
Claude Code 调用的接口根地址 |
ANTHROPIC_AUTH_TOKEN |
你的 NNYY API Key |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY |
开启网关模型发现 |
请注意:
ANTHROPIC_BASE_URL=https://api.nnyyai.com
这里不要写成:
ANTHROPIC_BASE_URL=https://api.nnyyai.com/v1
▸ 6.4 常见问题
Claude Code 一直连不上
请检查:
ANTHROPIC_BASE_URL是否写成了https://api.nnyyai.com。- 是否误加了
/v1。 ANTHROPIC_AUTH_TOKEN是否是 API Key,而不是卡密。- 你的平台是否已经开放 Anthropic Messages 兼容接口。
- 当前 Key 是否有对应模型权限。
重启终端后配置失效
说明你只执行了临时 export,没有写入 ~/.zshrc、~/.bashrc 或 Windows 用户环境变量。
请按“长期保存配置”重新设置。
▸ 8. 接入 Codex(CLI / 桌面版)
本节适合想在 Codex CLI 或 Codex 桌面版中使用 NNYY API 的用户。
系统导航:macOS 用户先看 7.1,Windows 用户先看 7.2。
▸ 7.1 macOS 接入教程
Codex 这里有两种常见用法:
| 用法 | 说明 |
|---|---|
| Codex CLI | 在终端里直接运行 codex |
| Codex 桌面版 | 打开 Codex App,在图形界面里选择项目并开始对话 |
如果你是要把 NNYY 第三方中转站 API 接入 Codex,核心不是网页里填地址,而是改 Codex 本地配置文件:
~/.codex/config.toml
也就是说:
- CLI 直接读取这份配置
- 桌面版 也可以沿用这份本地配置来接入 NNYY API
先安装并检查版本:
npm install -g @openai/codex
codex --version
或者:
brew install codex
codex --version
如果你使用桌面版,请先确认 Codex App 能正常打开。
第一步,先确保配置文件目录存在:
mkdir -p ~/.codex
touch ~/.codex/config.toml
ls -la ~/.codex
第二步,打开配置文件:
nano ~/.codex/config.toml
把下面内容完整粘贴进去:
model = "gpt-5"
model_provider = "nnyy"
[model_providers.nnyy]
name = "NNYY API"
base_url = "https://api.nnyyai.com/v1"
env_key = "NNYY_API_KEY"
wire_api = "responses"
保存方法:
- 按
Ctrl + O - 按回车确认保存
- 按
Ctrl + X退出
第三步,确认文件里确实已经写进去了:
cat ~/.codex/config.toml
第四步,设置 API Key:
export NNYY_API_KEY="这里填写你的 API Key"
如果你想长期保存到 zsh:
touch ~/.zshrc
echo 'export NNYY_API_KEY="这里填写你的 API Key"' >> ~/.zshrc
source ~/.zshrc
或者长期保存到 bash:
touch ~/.bashrc
echo 'export NNYY_API_KEY="这里填写你的 API Key"' >> ~/.bashrc
source ~/.bashrc
第五步,验证环境变量和配置文件:
echo $NNYY_API_KEY
grep -n "base_url\\|env_key\\|wire_api\\|model" ~/.codex/config.toml
如果你用的是桌面版,修改后请完全退出 Codex,再重新打开测试。
▸ 7.2 Windows 接入教程
如果你使用 CLI,先安装并检查版本:
npm install -g @openai/codex
codex --version
如果你用的是桌面版,请先确认 Codex App 能正常打开。
第一步,创建配置目录和配置文件:
New-Item -ItemType Directory -Path $env:USERPROFILE\.codex -Force
New-Item -ItemType File -Path $env:USERPROFILE\.codex\config.toml -Force
Get-ChildItem $env:USERPROFILE\.codex -Force
第二步,用记事本打开配置文件:
notepad $env:USERPROFILE\.codex\config.toml
把下面内容完整粘贴进去并保存:
model = "gpt-5"
model_provider = "nnyy"
[model_providers.nnyy]
name = "NNYY API"
base_url = "https://api.nnyyai.com/v1"
env_key = "NNYY_API_KEY"
wire_api = "responses"
第三步,保存后回到 PowerShell,检查文件内容:
Get-Content $env:USERPROFILE\.codex\config.toml
第四步,设置长期环境变量:
setx NNYY_API_KEY "这里填写你的 API Key"
然后先检查它是否已经写进用户环境变量:
[Environment]::GetEnvironmentVariable("NNYY_API_KEY","User")
执行完成后,关闭当前 PowerShell 和 Codex,再重新打开。
重新打开后再验证当前会话里是否已经能读取到:
echo $env:NNYY_API_KEY
▸ 7.3 两个系统都通用的关键配置
如果你不想新增 Provider,也可以直接把内置 OpenAI Provider 指向 NNYY 中转站。
config.toml 可以写成:
model = "gpt-5"
openai_base_url = "https://api.nnyyai.com/v1"
然后设置标准 OpenAI 环境变量:
macOS / Linux:
export OPENAI_API_KEY="这里填写你的 API Key"
Windows PowerShell:
setx OPENAI_API_KEY "这里填写你的 API Key"
这种方式更简单,但不如方案一清晰。更推荐你使用 单独的 nnyy Provider,后面切换和排查都更方便。
字段说明:
| 字段 | 含义 |
|---|---|
model |
默认使用的模型名 |
model_provider |
指定默认使用哪个服务商 |
[model_providers.nnyy] |
定义一个名为 nnyy 的 Provider |
name |
你给这个 Provider 起的显示名称 |
base_url |
NNYY 的 OpenAI 兼容接口地址 |
env_key |
从哪个环境变量读取 API Key |
wire_api |
Codex 使用的接口协议 |
这里要特别注意:Codex 仍然需要一个默认模型名。这不是 NNYY 额外要求,而是 Codex 自己的配置格式要求。
如果 gpt-5 不是你平台当前开放的模型,请到 api.nnyyai.com 控制台查看真实模型名,然后改成真实可用模型。
例如:
model = "gpt-4o-mini"
或者:
model = "gpt-5-codex"
▸ 7.4 Codex 桌面版测试步骤
如果你使用的是 Codex 桌面版,配置写好后按下面步骤测试:
- 完全退出 Codex 桌面版。
- 重新打开 Codex 桌面版。
- 选择一个项目文件夹。
- 确认使用
Local模式。 - 新建一个对话。
- 输入:
请回复:NNYY API 在 Codex 桌面版中配置成功。
如果能正常回复,说明桌面版已经通过本地配置接入成功。
▸ 7.5 常见问题
提示 401 / invalid api key
通常是下面几个原因:
- API Key 填错了
- 把卡密当成 API Key 了
- 环境变量没有生效
- 修改后没有重启 Codex
检查方式:
macOS / Linux:
echo $NNYY_API_KEY
Windows PowerShell:
echo $env:NNYY_API_KEY
提示 model not found
说明模型名不对。请去 api.nnyyai.com 后台复制真实模型名,然后修改:
model = "你的真实模型名"
桌面版没有读取配置
请检查配置文件路径是否正确。
macOS:
~/.codex/config.toml
Windows:
%USERPROFILE%\.codex\config.toml
修改后请完全退出 Codex 桌面版,再重新打开。
不确定应该用 responses 还是 chat
优先使用:
wire_api = "responses"
如果你的中转站暂时不支持 Responses API,再改成:
wire_api = "chat"
同时模型也要换成支持 Chat Completions 的模型。
▸ 9. 接入 Cursor
本节适合想在 Cursor 中使用自定义 OpenAI 接口的用户。
系统导航:macOS 用户先看 8.1,Windows 用户先看 8.2。
▸ 8.1 macOS 接入教程
先安装并确认版本:
brew install --cask cursor
cursor --version
Cursor 大多数时候不是让你手改某个固定文本配置文件,而是直接在应用内设置。
你可以先用终端确认应用已经装好,然后再从终端打开它:
ls /Applications | grep -i Cursor
open -a Cursor
打开后,在 Cursor 中寻找这些选项:
Models
OpenAI API Key
Override OpenAI Base URL
Custom API Base URL
OpenAI Compatible
填写:
API Key: 这里填写你的 API Key
Base URL: https://api.nnyyai.com/v1
▸ 8.2 Windows 接入教程
先安装并确认版本:
winget install Anysphere.Cursor
Cursor 大多数时候也是直接在图形界面里配置,不是手改某个固定文本配置文件。
先检查是否安装成功:
winget list Cursor
如果你启用了 Cursor CLI,也可以执行:
cursor --version
接着从开始菜单打开 Cursor,或者在 Cursor 已经加入命令路径时执行:
cursor .
然后在设置中填写:
API Key: 这里填写你的 API Key
Base URL: https://api.nnyyai.com/v1
▸ 8.3 通用说明
大多数情况下,Cursor 连通后会在模型列表中选择可用模型。
如果你当前版本的 Cursor 强制要求手动填写模型名,再填写 NNYY 平台真实开放的模型名。
▸ 8.4 测试 Cursor 是否可用
在 Cursor 中新建一个对话,输入:
请回复:NNYY API 在 Cursor 中配置成功。
如果模型正常回复,说明配置成功。
如果提示 401、403 或 model not found,请查看本文后面的错误排查章节。
▸ 10. 接入 Cherry Studio
本节适合想在 Cherry Studio 中添加 NNYY API 的用户。
系统导航:macOS 用户先看 9.1,Windows 用户先看 9.2。
▸ 9.1 macOS 接入教程
先从官方渠道下载 .dmg 安装包并完成安装。
Cherry Studio 一般也是在应用内配置服务商,不建议新手手改本地配置文件。
你可以先从终端确认应用是否已经放到 Applications,然后再打开:
ls /Applications | grep -i "Cherry"
版本检查一般在:
设置 → 关于
然后进入:
设置 → 模型服务 → 添加服务商
▸ 9.2 Windows 接入教程
先从官方渠道下载 .exe 或 .msi 安装包并完成安装。
Cherry Studio 一般也是在应用内配置服务商,不建议新手手改本地配置文件。
先确认程序是否已安装:
winget list | Select-String "Cherry"
版本检查一般在:
Help → About
然后进入:
设置 → 模型服务 → 添加服务商
▸ 9.3 新增服务商
打开 Cherry Studio,进入:
设置 → 模型服务 → 添加服务商
选择 OpenAI 或 OpenAI Compatible 类型。
▸ 9.4 填写服务商信息
参考配置:
服务商名称:NNYY
API Key:这里填写你的 API Key
API 地址 / Base URL:https://api.nnyyai.com/v1
▸ 9.5 添加模型
如果 Cherry Studio 没有自动拉取模型列表,可以手动添加模型名。
常见做法是:
连接先保存,模型在模型列表里再选或再添加
如果当前版本必须手动填写模型名,请以 NNYY 控制台实际开放的模型为准。
▸ 9.6 测试对话
新建对话,选择刚才添加的 NNYY 模型,发送:
请回复:Cherry Studio 配置成功。
能正常回复即表示配置完成。
▸ 11. 接入 NextChat
本节适合自建或使用 NextChat 的用户。
系统导航:macOS 用户先看 10.1,Windows 用户先看 10.2。
▸ 10.1 macOS 接入教程
如果你还没有 NextChat,最适合新手的方式是直接用一个单独目录保存 docker-compose.yml。
先创建目录并进入:
mkdir -p ~/nnyy-nextchat
cd ~/nnyy-nextchat
pwd
创建并打开配置文件:
touch docker-compose.yml
nano docker-compose.yml
把下面内容完整粘贴进去:
services:
nextchat:
image: yidadaa/chatgpt-next-web
container_name: nextchat
ports:
- "3000:3000"
environment:
OPENAI_API_KEY: "这里填写你的 API Key"
BASE_URL: https://api.nnyyai.com/v1
restart: unless-stopped
保存退出后,执行:
docker compose up -d
检查容器是否启动:
docker compose ps
docker compose logs --tail 50
▸ 10.2 Windows 接入教程
如果你还没有 NextChat,推荐新手也用单独目录保存 docker-compose.yml。
先创建目录并进入:
New-Item -ItemType Directory -Path $env:USERPROFILE\nnyy-nextchat -Force
Set-Location $env:USERPROFILE\nnyy-nextchat
Get-Location
创建并打开配置文件:
New-Item -ItemType File -Path .\docker-compose.yml -Force
notepad .\docker-compose.yml
把下面内容完整粘贴进去并保存:
services:
nextchat:
image: yidadaa/chatgpt-next-web
container_name: nextchat
ports:
- "3000:3000"
environment:
OPENAI_API_KEY: "这里填写你的 API Key"
BASE_URL: https://api.nnyyai.com/v1
restart: unless-stopped
保存后执行:
docker compose up -d
检查容器是否启动:
docker compose ps
docker compose logs --tail 50
▸ 10.3 页面设置方式
如果你的 NextChat 页面支持自定义接口,请在设置中填写:
API Key: 这里填写你的 API Key
Base URL: https://api.nnyyai.com/v1
模型通常在页面内选择;如果部署模板强制要求模型字段,再填写平台真实开放的模型名。
▸ 10.4 环境变量方式
如果你是自己部署 NextChat,也可以直接修改项目目录里的 .env 或 docker-compose.yml。
如果你不确定文件在哪,先在当前项目目录执行:
macOS / Linux:
find . -maxdepth 2 \( -name ".env" -o -name ".env.example" -o -name "docker-compose.yml" -o -name "compose.yml" \)
Windows PowerShell:
Get-ChildItem -Force -Recurse -Include .env,.env.example,docker-compose.yml,compose.yml -ErrorAction SilentlyContinue | Select-Object FullName
如果项目用的是 .env,常见写法如下:
OPENAI_API_KEY="这里填写你的 API Key"
BASE_URL=https://api.nnyyai.com/v1
不同部署方式变量名可能不同,请以你的项目配置文件为准。
▸ 12. 接入 Open WebUI
本节适合在本地或服务器部署 Open WebUI 的用户。
系统导航:macOS 用户先看 11.1,Windows 用户先看 11.2。
▸ 11.1 macOS 接入教程
先安装 Docker Desktop for Mac,然后运行:
docker run -d \
-p 3000:8080 \
--name open-webui \
--restart always \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:main
检查是否运行:
docker ps --filter name=open-webui
docker logs open-webui --tail 20
如果你更喜欢文件方式管理,也可以自己建一个目录保存 docker-compose.yml:
mkdir -p ~/nnyy-open-webui
cd ~/nnyy-open-webui
touch docker-compose.yml
nano docker-compose.yml
把下面内容粘贴进去:
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
container_name: open-webui
ports:
- "3000:8080"
volumes:
- open-webui:/app/backend/data
restart: always
volumes:
open-webui:
保存后执行:
docker compose up -d
docker compose ps
docker compose logs --tail 50
▸ 11.2 Windows 接入教程
先安装 Docker Desktop for Windows,然后在 PowerShell 里运行:
docker run -d -p 3000:8080 --name open-webui --restart always ghcr.io/open-webui/open-webui:main
检查是否运行:
docker ps --filter name=open-webui
docker logs open-webui --tail 20
如果你更喜欢文件方式管理,也可以执行:
New-Item -ItemType Directory -Path $env:USERPROFILE\nnyy-open-webui -Force
Set-Location $env:USERPROFILE\nnyy-open-webui
New-Item -ItemType File -Path .\docker-compose.yml -Force
notepad .\docker-compose.yml
把下面内容粘贴进去并保存:
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
container_name: open-webui
ports:
- "3000:8080"
volumes:
- open-webui:/app/backend/data
restart: always
volumes:
open-webui:
保存后执行:
docker compose up -d
docker compose ps
docker compose logs --tail 50
▸ 11.3 在后台添加连接
Open WebUI 连接 NNYY API 时,常见做法不是去宿主机里手改某个单独配置文件,而是进入网页后台设置。
进入 Open WebUI 管理后台,找到:
Settings → Connections → OpenAI API
或类似的 API 连接设置页面。
▸ 11.4 填写配置
API Base URL: https://api.nnyyai.com/v1
API Key: 这里填写你的 API Key
保存后,刷新模型列表或手动添加模型。
如果当前版本要求你显式填写模型名,再填写平台真实开放的模型名。
▸ 11.5 测试模型
回到聊天页面,选择刚才添加的模型,发送测试消息。
▸ 13. 接入 OpenClaw / openaiclaw
本节适合想把 NNYY API 接入 OpenClaw、openclaw 或用户口中的 openaiclaw 的用户。
公开资料中更常见的项目名称是 OpenClaw。如果用户说 openaiclaw,通常可以理解为想配置 OpenClaw 这类开源 AI 助手项目。
系统导航:macOS 用户先看 12.1,Windows 用户先看 12.2。
▸ 12.1 macOS 接入教程
先安装并检查版本:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
如果提示找不到 openclaw,请重新打开终端后再试。
如果你已经在某个 OpenClaw 项目目录里,但不知道 .env 或 .env.example 在哪里,可以先执行:
pwd
ls -la
find . -maxdepth 2 \( -name ".env" -o -name ".env.example" -o -name "docker-compose.yml" -o -name "compose.yml" \)
如果你找到了 .env.example,通常下一步就是:
cp .env.example .env
nano .env
▸ 12.2 Windows 接入教程
先安装并检查版本:
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw --version
如果提示找不到 openclaw,请重新打开 PowerShell 后再试。
如果你已经在某个 OpenClaw 项目目录里,但不知道 .env 或 .env.example 在哪里,可以先执行:
Get-Location
Get-ChildItem -Force
Get-ChildItem -Force -Recurse -Include .env,.env.example,docker-compose.yml,compose.yml -ErrorAction SilentlyContinue | Select-Object FullName
如果你找到了 .env.example,通常下一步就是:
Copy-Item .env.example .env -Force
notepad .env
▸ 12.3 先确认 OpenClaw 支持的接口类型
OpenClaw 这类 AI 助手项目通常会通过环境变量或配置文件读取模型服务商信息。你需要重点确认它支持哪一种接口:
| 接口类型 | NNYY 推荐填写 |
|---|---|
| OpenAI Compatible | https://api.nnyyai.com/v1 |
| Anthropic Compatible | https://api.nnyyai.com |
如果配置页面或 .env 文件里出现下面这些字段,一般说明它在使用 OpenAI 兼容接口:
OPENAI_API_KEY
OPENAI_BASE_URL
OPENAI_API_BASE
BASE_URL
如果出现下面这些字段,一般说明它在使用 Anthropic / Claude 兼容接口:
ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
新手优先推荐使用 OpenAI Compatible 方式,因为大多数第三方客户端和开源项目都支持这种配置。
▸ 12.4 OpenAI Compatible 推荐配置
如果 OpenClaw / openaiclaw 的配置文件支持 OpenAI 兼容模型,请填写:
API Key: 这里填写你的 API Key
Base URL: https://api.nnyyai.com/v1
常见 .env 写法如下:
OPENAI_API_KEY="这里填写你的 API Key"
OPENAI_BASE_URL=https://api.nnyyai.com/v1
如果项目使用的是 OPENAI_API_BASE,可以写成:
OPENAI_API_KEY="这里填写你的 API Key"
OPENAI_API_BASE=https://api.nnyyai.com/v1
如果项目使用的是 BASE_URL,可以写成:
OPENAI_API_KEY="这里填写你的 API Key"
BASE_URL=https://api.nnyyai.com/v1
请注意:不同 OpenClaw 版本或不同部署模板的变量名可能不完全一样。你应该优先使用项目 .env.example、README 或配置页面里实际出现的变量名。
如果某个版本强制要求你再填 OPENAI_MODEL,这时再填写平台真实开放的模型名。
▸ 12.5 Anthropic / Claude Compatible 配置
如果 OpenClaw / openaiclaw 选择 Claude 或 Anthropic Provider,请使用下面配置:
ANTHROPIC_BASE_URL=https://api.nnyyai.com
ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
或者有些项目会使用:
ANTHROPIC_API_KEY="这里填写你的 API Key"
ANTHROPIC_BASE_URL=https://api.nnyyai.com
这里要特别注意:
ANTHROPIC_BASE_URL=https://api.nnyyai.com
不要写成:
ANTHROPIC_BASE_URL=https://api.nnyyai.com/v1
Claude / Anthropic 兼容接口一般使用根地址,而不是 OpenAI 的 /v1 地址。
如果当前项目模板强制要求 ANTHROPIC_MODEL,再填写平台真实开放的 Claude 模型名。
▸ 12.6 Docker 部署时的配置方式
如果你是用 Docker 或 Docker Compose 部署 OpenClaw / openaiclaw,通常需要在 docker-compose.yml 里添加环境变量。
OpenAI Compatible 示例:
services:
openclaw:
image: your-openclaw-image
environment:
OPENAI_API_KEY: "这里填写你的 API Key"
OPENAI_BASE_URL: https://api.nnyyai.com/v1
Anthropic Compatible 示例:
services:
openclaw:
image: your-openclaw-image
environment:
ANTHROPIC_AUTH_TOKEN: "这里填写你的 API Key"
ANTHROPIC_BASE_URL: https://api.nnyyai.com
修改完成后,重新启动服务:
docker compose down
docker compose up -d
然后查看日志:
docker compose logs -f
如果日志里没有 API Key 错误、模型不存在、余额不足等提示,说明配置基本正常。
▸ 12.7 本地开发运行时的配置方式
如果你是从源码运行 OpenClaw / openaiclaw,通常流程如下:
git clone 项目仓库地址
cd 项目目录
cp .env.example .env
如果你是 Windows PowerShell,也可以用:
git clone 项目仓库地址
Set-Location 项目目录
Copy-Item .env.example .env -Force
notepad .env
然后编辑 .env 文件,加入 NNYY API 配置。
OpenAI Compatible 推荐:
OPENAI_API_KEY="这里填写你的 API Key"
OPENAI_BASE_URL=https://api.nnyyai.com/v1
保存后,建议立刻检查 .env 里是不是真的写进去了:
macOS / Linux:
grep -n "OPENAI_API_KEY\\|OPENAI_BASE_URL\\|ANTHROPIC_BASE_URL\\|ANTHROPIC_AUTH_TOKEN" .env
Windows PowerShell:
Get-Content .env
保存后重新启动项目。
如果项目强制要求模型字段,再补上平台真实开放的模型名。
常见启动命令可能是:
npm install
npm run dev
或:
pnpm install
pnpm dev
具体命令请以项目 README 为准。
▸ 12.8 测试 OpenClaw / openaiclaw 是否配置成功
启动项目后,可以在 OpenClaw 的聊天窗口或机器人对话里发送:
请回复:NNYY API 在 OpenClaw 中配置成功。
如果模型正常回复,说明配置成功。
如果没有回复,请先查看项目日志。常见日志关键词包括:
401
Unauthorized
invalid api key
model not found
insufficient quota
connection timeout
▸ 12.9 常见问题
OpenClaw 提示 invalid api key
请检查:
- 是否把卡密当成了 API Key。
- API Key 是否完整复制。
.env里是否多了引号、空格或不可见字符。- Docker 修改环境变量后是否重新启动容器。
OpenClaw 提示 model not found
请检查:
OPENAI_MODEL或ANTHROPIC_MODEL是否填写了平台真实开放的模型名。- 当前 API Key 是否有该模型权限。
- 模型名大小写是否一致。
OpenClaw 没有读取新的 .env
请检查:
- 是否修改了正确目录下的
.env文件。 - 项目是否需要重新启动。
- Docker Compose 是否需要重新构建或重启。
- 是否存在多个
.env文件导致改错位置。
OpenAI Compatible 和 Anthropic Compatible 应该选哪个
新手优先选择 OpenAI Compatible:
https://api.nnyyai.com/v1
只有当你明确知道 OpenClaw 当前功能需要 Claude / Anthropic Provider 时,再选择 Anthropic Compatible:
https://api.nnyyai.com
▸ 14. 使用 OpenAI SDK 调用 NNYY API
本节适合开发者或想写脚本调用 API 的用户。
▸ 13.1 Python 示例
先安装 OpenAI SDK:
pip install openai
创建 test_nnyy.py:
from openai import OpenAI
client = OpenAI(
api_key="这里填写你的 API Key",
base_url="https://api.nnyyai.com/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "请回复:Python 调用 NNYY API 成功。"}
],
)
print(response.choices[0].message.content)
运行:
python test_nnyy.py
▸ 13.2 Node.js 示例
先安装 SDK:
npm install openai
创建 test-nnyy.js:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "这里填写你的 API Key",
baseURL: "https://api.nnyyai.com/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "请回复:Node.js 调用 NNYY API 成功。" },
],
});
console.log(response.choices[0].message.content);
运行:
node test-nnyy.js
▸ 13.3 推荐使用环境变量保存 Key
不要把 API Key 直接写死在代码里。
更安全的方式是使用环境变量。
macOS / Linux:
export NNYY_API_KEY="这里填写你的 API Key"
Python 示例:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("NNYY_API_KEY"),
base_url="https://api.nnyyai.com/v1",
)
Node.js 示例:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NNYY_API_KEY,
baseURL: "https://api.nnyyai.com/v1",
});
▸ 15. 常见错误与解决方法
▸ 14.1 401 Unauthorized
含义:认证失败,系统不认可你的 API Key。
常见原因:
- API Key 复制不完整。
- 多复制了空格或换行。
- 把卡密当成 API Key 使用。
Authorization请求头格式错误。- API Key 已被删除或过期。
解决方法:
- 回到 API 平台重新复制 API Key。
- 确认 Key 以类似
sk-的格式开头。 - 确认请求头是:
Authorization: Bearer 这里填写你的 API Key
- 不要把卡密填到 API Key 位置。
▸ 14.2 403 Forbidden / 权限不足
含义:账号或 Key 没有权限调用当前资源。
常见原因:
- 账户余额不足。
- 当前 API Key 没有模型权限。
- 当前用户组不允许调用该模型。
- 开启了 IP 限制,但当前网络 IP 不在白名单。
解决方法:
- 检查账户余额。
- 检查 API Key 的模型权限。
- 关闭 IP 限制后重新测试。
- 如果当前客户端要求选择模型,换一个平台已开放的模型名。
▸ 14.3 model not found
含义:模型不存在或模型名写错。
常见原因:
- 客户端里填写的模型名不是平台真实模型名。
- 模型名大小写错误。
- 使用了平台没有开放的模型。
- Key 没有该模型权限。
解决方法:
- 回到
api.nnyyai.com控制台查看模型列表。 - 复制真实模型名。
- 粘贴到客户端模型名位置。
- 确认 API Key 有该模型权限。
▸ 14.4 insufficient quota / 余额不足
含义:账户余额不足或额度耗尽。
解决方法:
- 回到 API 平台查看余额。
- 确认卡密是否已经兑换。
- 如果余额不足,购买新套餐并兑换。
▸ 14.5 404 Not Found
常见原因:
- Base URL 写错。
- 把接口路径写重复了。
- 客户端自动拼接
/v1,你又手动填了/v1,导致路径异常。
解决方法:
如果客户端要求填写 Base URL,一般填写:
https://api.nnyyai.com/v1
如果客户端已经明确说明会自动添加 /v1,则可能需要填写:
https://api.nnyyai.com
具体以客户端说明为准。
▸ 14.6 请求超时
常见原因:
- 当前网络无法访问接口。
- 本地代理或防火墙拦截。
- 模型响应时间较长。
- 客户端超时时间设置太短。
解决方法:
- 先用浏览器打开
https://api.nnyyai.com。 - 换网络测试。
- 关闭或调整代理。
- 使用 curl 测试接口。
- 在客户端中适当调大 timeout。
▸ 14.7 Claude Code 普通客户端能用但 Claude Code 不行
常见原因:
- Claude Code 使用了错误地址。
ANTHROPIC_BASE_URL误写成/v1。- 平台没有开放 Anthropic Messages 兼容接口。
- 没有设置
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1。
解决方法:
确认配置为:
export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
▸ 16. 新手配置检查清单
在联系客服或反馈问题前,可以先按下面清单自查。
▸ 15.1 账户与余额
- 我已经在
nnyyai.com购买套餐。 - 我已经拿到卡密。
- 我已经登录
api.nnyyai.com。 - 我已经把卡密兑换成余额。
- 我的 API 平台账户里有可用余额。
▸ 15.2 API Key
- 我创建了 API Key。
- 我没有把卡密当成 API Key。
- API Key 没有多复制空格或换行。
- API Key 没有过期。
- API Key 有对应模型权限。
▸ 15.3 地址与模型
- OpenAI 兼容客户端使用
https://api.nnyyai.com/v1。 - Claude Code 使用
https://api.nnyyai.com。 - 如果客户端强制要求模型字段,我填写的是平台真实开放模型名。
- 客户端中没有重复填写
/v1。
▸ 15.4 本地环境
- 终端重新打开后环境变量仍然存在。
- Windows 使用
setx后已经重启终端。 - macOS / Linux 已经执行
source ~/.zshrc或source ~/.bashrc。 - 本地网络可以访问 API 平台。
▸ 17. 推荐安全习惯
为了避免 API Key 泄露或被盗刷,建议遵守以下规则:
- 不要把 API Key 发到公开群聊。
- 不要把 API Key 写进公开仓库。
- 不要在截图中暴露完整 API Key。
- 每个客户端单独创建一个 API Key。
- 不使用的 Key 及时删除。
- 正式使用时给 Key 设置合理权限。
- 有固定 IP 时再考虑开启 IP 限制。
- 发现异常扣费时,第一时间删除可疑 API Key。
▸ 18. 给客服或管理员反馈问题时应提供什么
为了更快定位问题,反馈时建议提供以下信息:
- 你使用的客户端名称,例如 Claude Code、Codex、Cursor、Cherry Studio。
- 你填写的 Base URL,但不要提供完整 API Key。
- 如果你有填写模型名,再提供你使用的模型名。
- 报错截图或报错文本。
- 是否已经成功兑换余额。
- 是否用 curl 测试过。
- 大概出现问题的时间。
请不要直接发送完整 API Key。可以只提供前后几位,例如:
sk-abc...xyz
▸ 19. 最小可用配置速查
▸ 18.1 OpenAI 兼容客户端
Base URL: https://api.nnyyai.com/v1
API Key: 这里填写你的 API Key
大多数客户端到这一步就已经能连上平台。模型通常在客户端里再选;如果当前客户端强制要求模型字段,再填写平台真实开放的模型名。
▸ 18.2 Claude Code
export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN="这里填写你的 API Key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
▸ 18.3 Codex(CLI / 桌面版)
export NNYY_API_KEY="这里填写你的 API Key"
model = "gpt-5"
model_provider = "nnyy"
[model_providers.nnyy]
name = "NNYY"
base_url = "https://api.nnyyai.com/v1"
env_key = "NNYY_API_KEY"
wire_api = "responses"
说明:
- Codex 仍然需要在
config.toml中指定一个默认模型,这是 Codex 本身的要求。 - Codex 桌面版也可以沿用这份本地配置;修改后请重启桌面应用再测试。
▸ 20. 总结
NNYY API 的使用可以概括为一句话:
先在
nnyyai.com买套餐拿卡密,再到api.nnyyai.com兑换余额并创建 API Key,最后把 API Key 和正确的 Base URL 填到客户端里。
新手最容易出错的地方有三个:
- 把卡密当成 API Key。
- Base URL 填错,尤其是 Claude Code 是否要加
/v1。 - 在客户端强制要求模型字段时,填了平台未开放或写错的模型名。
只要按本文流程检查,一般都可以独立完成配置。