NNYY API 新手详细使用教程

NNYY 官方教程 最后更新:2026/5/10 适合第一次接入第三方 API 的新手

本教程面向第一次使用第三方 API 中转站的新手用户。你不需要有编程经验,只要按步骤操作,就可以完成购买套餐、兑换卡密、创建 API Key、配置客户端,并完成第一次接口调用。

0. 先看懂整个流程

在开始之前,请先记住 NNYY 的三个常用地址和它们的分工:

地址 用途 新手理解
https://nnyyai.com 购买套餐、获取卡密 相当于“买充值卡”的地方
https://api.nnyyai.com 登录 API 平台、兑换余额、创建 API Key 相当于“账户后台”
https://api.nnyyai.com/v1 OpenAI 兼容接口地址 填到客户端里的 Base URL

完整流程如下:

  1. https://nnyyai.com 购买套餐。
  2. 获取卡密或兑换码。
  3. 打开 https://api.nnyyai.com 并登录。
  4. 把卡密兑换成 API 平台余额。
  5. 在 API 平台创建 API Key。
  6. 把 API Key 和接口地址填入客户端。
  7. 发送测试请求,确认可以正常使用。

请特别注意:卡密不是 API Key

卡密只能用于兑换余额。真正给客户端、脚本、Claude Code、Codex、Cursor、Cherry Studio、NextChat 等工具使用的是你在 API 平台里创建的 API Key


快速入口
Windows 系统接入导航(点击展开后直达对应教程)

Windows 文档里如果出现:

setx 变量名 "变量值"

这就是 长期环境变量 的写法。设置一次后,电脑重启后也还在,不需要每次重设。
你只需要在设置完成后,关闭并重新打开终端、Claude Code、Codex 或其他客户端,让新环境变量生效。

macOS 系统接入导航(点击展开后直达对应教程)

macOS 如果你把环境变量写进:

~/.zshrc

或:

~/.bashrc

那它也是 长期保存 的。以后重启终端或重启电脑后依然有效。

不会找配置文件时,先按这个思路操作

很多新手卡住,不是因为不会填 URLAPI Key,而是不知道文件到底在哪。你可以先记住这 4 条:

  1. Claude Code 主要改的是终端启动文件,macOS 常见是 ~/.zshrc~/.bashrc;Windows 一般不改文本文件,而是写入用户环境变量
  2. Codex 主要改的是本地配置文件:macOS 是 ~/.codex/config.toml,Windows 是 %USERPROFILE%\.codex\config.toml
  3. NextChatOpen WebUIOpenClaw 这类自建项目,常见是改项目目录里的 .env.env.exampledocker-compose.ymlcompose.yml
  4. 如果你不知道自己该改哪个文件,优先回到本文对应客户端小节,直接照那一节的完整命令执行,不要一上来全盘乱搜。

macOS 可以先执行:

echo $SHELL
pwd
ls -la ~ | grep -E '\.zshrc|\.bashrc|\.codex'

用途:

  • echo $SHELL:看你当前更可能用 zsh 还是 bash
  • pwd:看你当前终端正在哪个目录
  • 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 输入卡密并兑换

操作步骤:

  1. 复制你购买后获得的卡密。
  2. 粘贴到兑换输入框中。
  3. 检查是否多复制了空格或换行。
  4. 点击兑换、确认或提交。
  5. 等待系统提示兑换成功。
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 URLAPI 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 如果测试失败怎么办

请优先检查以下四项:

  1. API Key 是否完整复制。
  2. Authorization 前面是否有 Bearer
  3. Base URL 是否写成了 https://api.nnyyai.com/v1
  4. 模型名是否是平台真实开放的模型名。

7. 接入 Claude Code

本节适合想在 Claude Code 中使用 NNYY API 的用户。

系统导航:macOS 用户先看 6.1Windows 用户先看 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.1Windows 用户先看 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 桌面版,配置写好后按下面步骤测试:

  1. 完全退出 Codex 桌面版。
  2. 重新打开 Codex 桌面版。
  3. 选择一个项目文件夹。
  4. 确认使用 Local 模式。
  5. 新建一个对话。
  6. 输入:
请回复: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.1Windows 用户先看 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.1Windows 用户先看 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.1Windows 用户先看 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,也可以直接修改项目目录里的 .envdocker-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.1Windows 用户先看 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.1Windows 用户先看 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_MODELANTHROPIC_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 已被删除或过期。

解决方法:

  1. 回到 API 平台重新复制 API Key。
  2. 确认 Key 以类似 sk- 的格式开头。
  3. 确认请求头是:
Authorization: Bearer 这里填写你的 API Key
  1. 不要把卡密填到 API Key 位置。
14.2 403 Forbidden / 权限不足

含义:账号或 Key 没有权限调用当前资源。

常见原因:

  • 账户余额不足。
  • 当前 API Key 没有模型权限。
  • 当前用户组不允许调用该模型。
  • 开启了 IP 限制,但当前网络 IP 不在白名单。

解决方法:

  1. 检查账户余额。
  2. 检查 API Key 的模型权限。
  3. 关闭 IP 限制后重新测试。
  4. 如果当前客户端要求选择模型,换一个平台已开放的模型名。
14.3 model not found

含义:模型不存在或模型名写错。

常见原因:

  • 客户端里填写的模型名不是平台真实模型名。
  • 模型名大小写错误。
  • 使用了平台没有开放的模型。
  • Key 没有该模型权限。

解决方法:

  1. 回到 api.nnyyai.com 控制台查看模型列表。
  2. 复制真实模型名。
  3. 粘贴到客户端模型名位置。
  4. 确认 API Key 有该模型权限。
14.4 insufficient quota / 余额不足

含义:账户余额不足或额度耗尽。

解决方法:

  1. 回到 API 平台查看余额。
  2. 确认卡密是否已经兑换。
  3. 如果余额不足,购买新套餐并兑换。
14.5 404 Not Found

常见原因:

  • Base URL 写错。
  • 把接口路径写重复了。
  • 客户端自动拼接 /v1,你又手动填了 /v1,导致路径异常。

解决方法:

如果客户端要求填写 Base URL,一般填写:

https://api.nnyyai.com/v1

如果客户端已经明确说明会自动添加 /v1,则可能需要填写:

https://api.nnyyai.com

具体以客户端说明为准。

14.6 请求超时

常见原因:

  • 当前网络无法访问接口。
  • 本地代理或防火墙拦截。
  • 模型响应时间较长。
  • 客户端超时时间设置太短。

解决方法:

  1. 先用浏览器打开 https://api.nnyyai.com
  2. 换网络测试。
  3. 关闭或调整代理。
  4. 使用 curl 测试接口。
  5. 在客户端中适当调大 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 ~/.zshrcsource ~/.bashrc
  • 本地网络可以访问 API 平台。

17. 推荐安全习惯

为了避免 API Key 泄露或被盗刷,建议遵守以下规则:

  1. 不要把 API Key 发到公开群聊。
  2. 不要把 API Key 写进公开仓库。
  3. 不要在截图中暴露完整 API Key。
  4. 每个客户端单独创建一个 API Key。
  5. 不使用的 Key 及时删除。
  6. 正式使用时给 Key 设置合理权限。
  7. 有固定 IP 时再考虑开启 IP 限制。
  8. 发现异常扣费时,第一时间删除可疑 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 填到客户端里。

新手最容易出错的地方有三个:

  1. 把卡密当成 API Key。
  2. Base URL 填错,尤其是 Claude Code 是否要加 /v1
  3. 在客户端强制要求模型字段时,填了平台未开放或写错的模型名。

只要按本文流程检查,一般都可以独立完成配置。