NNYY API 新手详细使用教程

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

完整流程如下：

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。

开始前，你需要准备以下内容：

• 一个可以正常访问网页的浏览器，例如 Chrome、Edge、Safari。
• 一个可以接收登录验证信息的邮箱或账号。
• 已购买的 NNYY 套餐卡密。
• 需要接入的客户端或工具，例如 Claude Code、Codex、Cursor、Cherry Studio、NextChat、Open WebUI、OpenClaw 等。

如果你只是想先测试接口是否能用，可以先不安装复杂客户端，直接使用终端里的 curl 命令测试。

1.1 打开套餐购买页面

打开浏览器，访问：

https://nnyyai.com

在页面中选择适合自己的套餐，然后按页面提示完成购买。

1.2 找到卡密或兑换码

购买完成后，你通常会得到一串卡密或兑换码。

卡密可能出现在以下位置之一：

• 购买成功页面
• 订单详情页面
• 邮箱通知
• 用户中心
• 客服或系统消息

卡密通常是一串较长的字符。请完整复制，不要漏掉前后字符，也不要额外复制空格、换行或中文标点。

1.3 卡密和 API Key 的区别

很多新手会把卡密直接填到客户端里，这是错误的。

简单理解：

• 卡密 = 充值码
• API Key = 调用接口的密码

你需要先用卡密充值，再创建 API Key。

2.1 打开 API 平台

访问：

https://api.nnyyai.com

登录你的账号。如果你还没有账号，请按页面提示注册。

2.2 找到兑换入口

登录后，在控制台或侧边栏中寻找类似下面的入口：

• 兑换码
• 卡密兑换
• 充值兑换
• 充值
• 钱包
• 余额

不同版本后台的入口名称可能略有不同，但核心操作都是：把购买到的卡密兑换成账户余额。

2.3 输入卡密并兑换

操作步骤：

1. 复制你购买后获得的卡密。
2. 粘贴到兑换输入框中。
3. 检查是否多复制了空格或换行。
4. 点击兑换、确认或提交。
5. 等待系统提示兑换成功。

2.4 确认余额是否到账

兑换完成后，请回到账户余额、钱包或用量页面，确认余额已经增加。

如果余额没有变化，请检查：

• 是否登录了正确账号。
• 卡密是否已经被使用过。
• 卡密是否复制完整。
• 是否兑换到了其他账户。
• 页面是否需要刷新。

只有账户里有可用余额，后续调用 API 才能正常扣费使用。

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，关闭页面后可能无法再次查看完整内容。

不同工具需要填写的地址可能不同。

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 如何判断自己该填哪个地址

在配置客户端前，建议先测试 API Key 和接口地址是否可用。

5.1 macOS / Linux 测试方法

打开终端，执行下面命令。

请把 sk-xxxxxxxxxxxxxxxxxxxxxxxx 换成你自己的 API Key。

curl https://api.nnyyai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请回复一句：NNYY 接口连接成功。"}
    ]
  }'

如果返回内容里出现模型回复，说明接口已经连通。

5.2 Windows PowerShell 测试方法

Windows 用户可以打开 PowerShell，执行：

$headers = @{
  "Content-Type" = "application/json"
  "Authorization" = "Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx"
}

$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. 模型名是否是平台真实开放的模型名。

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

安装与版本检查

先确认 Claude Code 已安装；没安装先装，装完先查版本。

macOS / Linux / WSL 推荐安装：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

如果你更习惯 npm，也可以执行：

npm install -g @anthropic-ai/claude-code

检查版本：

claude --version

如果提示找不到 claude 命令，请重新打开终端后再试。

6.1 临时配置环境变量

macOS / Linux 用户打开终端，执行：

export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

说明：

请注意：

ANTHROPIC_BASE_URL=https://api.nnyyai.com

这里不要写成：

ANTHROPIC_BASE_URL=https://api.nnyyai.com/v1

6.2 macOS / Linux 长期保存配置

如果你使用 zsh，执行：

echo 'export ANTHROPIC_BASE_URL=https://api.nnyyai.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.zshrc
echo 'export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1' >> ~/.zshrc
source ~/.zshrc

如果你使用 bash，执行：

echo 'export ANTHROPIC_BASE_URL=https://api.nnyyai.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.bashrc
echo 'export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1' >> ~/.bashrc
source ~/.bashrc

6.3 Windows PowerShell 长期保存配置

打开 PowerShell，执行：

setx ANTHROPIC_BASE_URL "https://api.nnyyai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
setx CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY "1"

执行完成后，请关闭当前 PowerShell 窗口，重新打开一个新的终端窗口。

6.4 验证环境变量是否生效

macOS / Linux：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

如果能看到你设置的地址和 Key，说明环境变量已经生效。

6.5 常见问题

Claude Code 一直连不上

请检查：

• ANTHROPIC_BASE_URL 是否写成了 https://api.nnyyai.com。
• 是否误加了 /v1。
• ANTHROPIC_AUTH_TOKEN 是否是 API Key，而不是卡密。
• 你的平台是否已经开放 Anthropic Messages 兼容接口。
• 当前 Key 是否有对应模型权限。

重启终端后配置失效

说明你只执行了临时 export，没有写入 ~/.zshrc、~/.bashrc 或 Windows 用户环境变量。

请按“长期保存配置”重新设置。

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

安装与版本检查

Codex CLI 先装好，再继续配置 NNYY。

npm 安装：

npm install -g @openai/codex

macOS Homebrew 安装：

brew install codex

检查版本：

codex --version

如果你的版本命令不支持，也可以直接运行：

codex

能进入 Codex 交互界面，就说明安装基本正常。

7.1 设置 API Key 环境变量

macOS / Linux 临时设置：

export NNYY_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

macOS / Linux 长期保存到 zsh：

echo 'export NNYY_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.zshrc
source ~/.zshrc

macOS / Linux 长期保存到 bash：

echo 'export NNYY_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell：

setx NNYY_API_KEY "sk-xxxxxxxxxxxxxxxxxxxxxxxx"

Windows 设置完成后，请重新打开终端。

7.2 创建 Codex 配置文件

Codex 配置文件路径通常是：

~/.codex/config.toml

如果目录不存在，可以先创建目录。

macOS / Linux：

mkdir -p ~/.codex
nano ~/.codex/config.toml

然后写入以下内容：

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 仍然需要一个默认模型名。这不是 NNYY 额外要求，而是 Codex 自己的配置格式要求。

字段说明：

7.3 修改默认模型名

如果 gpt-5 不是你平台当前开放的模型，请到 api.nnyyai.com 控制台查看真实模型名，然后修改：

model = "你的模型名"

例如：

model = "gpt-4o-mini"

7.4 验证 Codex 配置

设置完成后，重新打开终端，确认环境变量存在：

macOS / Linux：

echo $NNYY_API_KEY

Windows PowerShell：

echo $env:NNYY_API_KEY

如果能看到你的 Key，说明 Codex 可以读取到环境变量。

本节适合想在 Cursor 中使用自定义 OpenAI 接口的用户。

安装与版本检查

推荐直接从 Cursor 官方网站下载安装包。

也可以使用：

macOS Homebrew：

brew install --cask cursor

Windows：

winget install Anysphere.Cursor

版本检查方式：

Help → About

如果你已经启用了 Cursor CLI，也可以执行：

cursor --version

8.1 打开 Cursor 设置

在 Cursor 中进入设置页面，寻找以下相关选项：

• Models
• OpenAI API Key
• Override OpenAI Base URL
• Custom API Base URL
• OpenAI Compatible

不同版本 Cursor 设置名称可能会变化，请以当前客户端页面为准。

8.2 填写配置

通常先填写两项：

API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
Base URL: https://api.nnyyai.com/v1

大多数情况下，Cursor 连通后会在模型列表中选择可用模型。

如果你当前版本的 Cursor 强制要求手动填写模型名，再填写 NNYY 平台真实开放的模型名。

8.3 测试 Cursor 是否可用

在 Cursor 中新建一个对话，输入：

请回复：NNYY API 在 Cursor 中配置成功。

如果模型正常回复，说明配置成功。

如果提示 401、403 或 model not found，请查看本文后面的错误排查章节。

本节适合想在 Cherry Studio 中添加 NNYY API 的用户。

安装与版本检查

Cherry Studio 推荐从官方站点或官方 GitHub Release 下载。

常见安装包：

• Windows：.exe 或 .msi
• macOS：.dmg
• Linux：.AppImage、.deb、.rpm

版本检查通常在图形界面中查看：

设置 → 关于

或：

Help → About

9.1 新增服务商

打开 Cherry Studio，进入：

设置 → 模型服务 → 添加服务商

选择 OpenAI 或 OpenAI Compatible 类型。

9.2 填写服务商信息

参考配置：

服务商名称：NNYY
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx
API 地址 / Base URL：https://api.nnyyai.com/v1

9.3 添加模型

如果 Cherry Studio 没有自动拉取模型列表，可以手动添加模型名。

常见做法是：

连接先保存，模型在模型列表里再选或再添加

如果当前版本必须手动填写模型名，请以 NNYY 控制台实际开放的模型为准。

9.4 测试对话

新建对话，选择刚才添加的 NNYY 模型，发送：

请回复：Cherry Studio 配置成功。

能正常回复即表示配置完成。

本节适合自建或使用 NextChat 的用户。

安装与版本检查

如果你还没有 NextChat，可以先用 Docker 跑起来：

docker run -d \
  --name nextchat \
  -p 3000:3000 \
  yidadaa/chatgpt-next-web

检查容器是否启动：

docker ps --filter name=nextchat

如果你是源码运行，也可以用下面方式确认版本信息：

cat package.json | grep '"version"'

10.1 页面设置方式

如果你的 NextChat 页面支持自定义接口，请在设置中填写：

API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
Base URL: https://api.nnyyai.com/v1

模型通常在页面内选择；如果部署模板强制要求模型字段，再填写平台真实开放的模型名。

10.2 环境变量方式

如果你是自己部署 NextChat，可以在部署环境中设置类似变量：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
BASE_URL=https://api.nnyyai.com/v1

不同部署方式变量名可能不同，请以你的项目配置文件为准。

本节适合在本地或服务器部署 Open WebUI 的用户。

安装与版本检查

Open WebUI 推荐使用 Docker：

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

11.1 在后台添加连接

进入 Open WebUI 管理后台，找到：

Settings → Connections → OpenAI API

或类似的 API 连接设置页面。

11.2 填写配置

API Base URL: https://api.nnyyai.com/v1
API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx

保存后，刷新模型列表或手动添加模型。

如果当前版本要求你显式填写模型名，再填写平台真实开放的模型名。

11.3 测试模型

回到聊天页面，选择刚才添加的模型，发送测试消息。

本节适合想把 NNYY API 接入 OpenClaw、openclaw 或用户口中的 openaiclaw 的用户。

公开资料中更常见的项目名称是 OpenClaw。如果用户说 openaiclaw，通常可以理解为想配置 OpenClaw 这类开源 AI 助手项目。

安装与版本检查

macOS / Linux / WSL 推荐安装：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

检查版本：

openclaw --version

如果提示找不到 openclaw，请重新打开终端，或检查 PATH。

12.1 先确认 OpenClaw 支持的接口类型

OpenClaw 这类 AI 助手项目通常会通过环境变量或配置文件读取模型服务商信息。你需要重点确认它支持哪一种接口：

如果配置页面或 .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.2 OpenAI Compatible 推荐配置

如果 OpenClaw / openaiclaw 的配置文件支持 OpenAI 兼容模型，请填写：

API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
Base URL: https://api.nnyyai.com/v1

常见 .env 写法如下：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://api.nnyyai.com/v1

如果项目使用的是 OPENAI_API_BASE，可以写成：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_API_BASE=https://api.nnyyai.com/v1

如果项目使用的是 BASE_URL，可以写成：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
BASE_URL=https://api.nnyyai.com/v1

请注意：不同 OpenClaw 版本或不同部署模板的变量名可能不完全一样。你应该优先使用项目 .env.example、README 或配置页面里实际出现的变量名。

如果某个版本强制要求你再填 OPENAI_MODEL，这时再填写平台真实开放的模型名。

12.3 Anthropic / Claude Compatible 配置

如果 OpenClaw / openaiclaw 选择 Claude 或 Anthropic Provider，请使用下面配置：

ANTHROPIC_BASE_URL=https://api.nnyyai.com
ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx

或者有些项目会使用：

ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
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.4 Docker 部署时的配置方式

如果你是用 Docker 或 Docker Compose 部署 OpenClaw / openaiclaw，通常需要在 docker-compose.yml 里添加环境变量。

OpenAI Compatible 示例：

services:
  openclaw:
    image: your-openclaw-image
    environment:
      OPENAI_API_KEY: sk-xxxxxxxxxxxxxxxxxxxxxxxx
      OPENAI_BASE_URL: https://api.nnyyai.com/v1

Anthropic Compatible 示例：

services:
  openclaw:
    image: your-openclaw-image
    environment:
      ANTHROPIC_AUTH_TOKEN: sk-xxxxxxxxxxxxxxxxxxxxxxxx
      ANTHROPIC_BASE_URL: https://api.nnyyai.com

修改完成后，重新启动服务：

docker compose down
docker compose up -d

然后查看日志：

docker compose logs -f

如果日志里没有 API Key 错误、模型不存在、余额不足等提示，说明配置基本正常。

12.5 本地开发运行时的配置方式

如果你是从源码运行 OpenClaw / openaiclaw，通常流程如下：

git clone 项目仓库地址
cd 项目目录
cp .env.example .env

然后编辑 .env 文件，加入 NNYY API 配置。

OpenAI Compatible 推荐：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://api.nnyyai.com/v1

保存后重新启动项目。

如果项目强制要求模型字段，再补上平台真实开放的模型名。

常见启动命令可能是：

npm install
npm run dev

或：

pnpm install
pnpm dev

具体命令请以项目 README 为准。

12.6 测试 OpenClaw / openaiclaw 是否配置成功

启动项目后，可以在 OpenClaw 的聊天窗口或机器人对话里发送：

请回复：NNYY API 在 OpenClaw 中配置成功。

如果模型正常回复，说明配置成功。

如果没有回复，请先查看项目日志。常见日志关键词包括：

401
Unauthorized
invalid api key
model not found
insufficient quota
connection timeout

12.7 常见问题

1. OpenClaw 提示 invalid api key

请检查：

• 是否把卡密当成了 API Key。
• API Key 是否完整复制。
• .env 里是否多了引号、空格或不可见字符。
• Docker 修改环境变量后是否重新启动容器。

2. OpenClaw 提示 model not found

请检查：

• OPENAI_MODEL 或 ANTHROPIC_MODEL 是否填写了平台真实开放的模型名。
• 当前 API Key 是否有该模型权限。
• 模型名大小写是否一致。

3. OpenClaw 没有读取新的 .env

请检查：

• 是否修改了正确目录下的 .env 文件。
• 项目是否需要重新启动。
• Docker Compose 是否需要重新构建或重启。
• 是否存在多个 .env 文件导致改错位置。

4. OpenAI Compatible 和 Anthropic Compatible 应该选哪个

新手优先选择 OpenAI Compatible：

https://api.nnyyai.com/v1

只有当你明确知道 OpenClaw 当前功能需要 Claude / Anthropic Provider 时，再选择 Anthropic Compatible：

https://api.nnyyai.com

本节适合开发者或想写脚本调用 API 的用户。

12.1 Python 示例

先安装 OpenAI SDK：

pip install openai

创建 test_nnyy.py：

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx",
    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

12.2 Node.js 示例

先安装 SDK：

npm install openai

创建 test-nnyy.js：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
  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

12.3 推荐使用环境变量保存 Key

不要把 API Key 直接写死在代码里。

更安全的方式是使用环境变量。

macOS / Linux：

export NNYY_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

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",
});

13.1 401 Unauthorized

含义：认证失败，系统不认可你的 API Key。

常见原因：

• API Key 复制不完整。
• 多复制了空格或换行。
• 把卡密当成 API Key 使用。
• Authorization 请求头格式错误。
• API Key 已被删除或过期。

解决方法：

1. 回到 API 平台重新复制 API Key。
2. 确认 Key 以类似 sk- 的格式开头。
3. 确认请求头是：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx

4. 不要把卡密填到 API Key 位置。

13.2 403 Forbidden / 权限不足

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

常见原因：

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

解决方法：

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

13.3 model not found

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

常见原因：

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

解决方法：

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

13.4 insufficient quota / 余额不足

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

解决方法：

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

13.5 404 Not Found

常见原因：

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

解决方法：

如果客户端要求填写 Base URL，一般填写：

https://api.nnyyai.com/v1

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

https://api.nnyyai.com

具体以客户端说明为准。

13.6 请求超时

常见原因：

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

解决方法：

1. 先用浏览器打开 https://api.nnyyai.com。
2. 换网络测试。
3. 关闭或调整代理。
4. 使用 curl 测试接口。
5. 在客户端中适当调大 timeout。

13.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=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

在联系客服或反馈问题前，可以先按下面清单自查。

账户与余额

• 我已经在 nnyyai.com 购买套餐。
• 我已经拿到卡密。
• 我已经登录 api.nnyyai.com。
• 我已经把卡密兑换成余额。
• 我的 API 平台账户里有可用余额。

API Key

• 我创建了 API Key。
• 我没有把卡密当成 API Key。
• API Key 没有多复制空格或换行。
• API Key 没有过期。
• API Key 有对应模型权限。

地址与模型

• OpenAI 兼容客户端使用 https://api.nnyyai.com/v1。
• Claude Code 使用 https://api.nnyyai.com。
• 如果客户端强制要求模型字段，我填写的是平台真实开放模型名。
• 客户端中没有重复填写 /v1。

本地环境

• 终端重新打开后环境变量仍然存在。
• Windows 使用 setx 后已经重启终端。
• macOS / Linux 已经执行 source ~/.zshrc 或 source ~/.bashrc。
• 本地网络可以访问 API 平台。

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

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

为了更快定位问题，反馈时建议提供以下信息：

• 你使用的客户端名称，例如 Claude Code、Codex、Cursor、Cherry Studio。
• 你填写的 Base URL，但不要提供完整 API Key。
• 如果你有填写模型名，再提供你使用的模型名。
• 报错截图或报错文本。
• 是否已经成功兑换余额。
• 是否用 curl 测试过。
• 大概出现问题的时间。

请不要直接发送完整 API Key。可以只提供前后几位，例如：

sk-abc...xyz

OpenAI 兼容客户端

Base URL: https://api.nnyyai.com/v1
API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx

大多数客户端到这一步就已经能连上平台。模型通常在客户端里再选；如果当前客户端强制要求模型字段，再填写平台真实开放的模型名。

Claude Code

export ANTHROPIC_BASE_URL=https://api.nnyyai.com
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Codex

export NNYY_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

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 本身的要求。

NNYY API 的使用可以概括为一句话：

先在 nnyyai.com 买套餐拿卡密，再到 api.nnyyai.com 兑换余额并创建 API Key，最后把 API Key 和正确的 Base URL 填到客户端里。

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

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

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