获取与配置 API Key
调用 NextAI Code 的所有模型接口都需要 API Key。最短路径:
- 登录
https://www.nextai-code.com,进入控制台「API Keys」页(/console/keys),点击「创建新密钥」。 - 复制以
sk-开头的 API Key,写入环境变量NEXTAI_API_KEY。 - 以
https://www.nextai-code.com/v1为 Base URL 发起请求。
export NEXTAI_API_KEY="YOUR_API_KEY"
curl https://www.nextai-code.com/v1/models \
-H "Authorization: Bearer $NEXTAI_API_KEY"
返回模型列表即表示 API Key 可用。各协议的 Base URL 与鉴权头见 Base URL 总览。
创建 API Key
在「API Keys」页点击「创建新密钥」,填写以下字段后提交:
| 字段 | 说明 |
|---|---|
| 名称 | 必填,用于区分用途,最长 30 个字符 |
| 分组 | 必填,决定可用模型与计费倍率,见 分组 |
| 扣费方式 | 从账户余额扣,或绑定一个已购套餐(仅在有套餐时出现) |
| 不限制此密钥额度 / 此密钥可用额度 | 二选一:不单独设上限,或为这个 API Key 设置额度上限 |
| 高级设置 · 过期时间 | 留空表示永不过期 |
| 高级设置 · 模型限制 | 留空表示允许分组内所有模型 |
| 高级设置 · IP白名单 | 一行一个 IP,留空不限制 |
| 高级设置 · 新建数量 | 一次批量创建多个配置相同的 API Key |
创建后可在列表中「显示 / 复制」完整 API Key,形如 sk- 加 48 位字母数字。
一个账号可以创建多个 API Key。建议按项目 / 环境分别创建,便于单独限额、停用和对账。
配置到环境变量
把 API Key 放在环境变量中,不要写进代码或提交到仓库。本文档所有示例都读取 NEXTAI_API_KEY。
macOS / Linux
当前终端临时生效:
export NEXTAI_API_KEY="YOUR_API_KEY"
永久生效(按你使用的 shell 选择文件):
# zsh(macOS 默认)
echo 'export NEXTAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc
# bash
echo 'export NEXTAI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc
验证:
echo $NEXTAI_API_KEY
Windows
PowerShell,当前窗口临时生效:
$env:NEXTAI_API_KEY = "YOUR_API_KEY"
永久写入用户环境变量(需重新打开终端才能读到):
[Environment]::SetEnvironmentVariable("NEXTAI_API_KEY", "YOUR_API_KEY", "User")
CMD 永久写入:
setx NEXTAI_API_KEY "YOUR_API_KEY"
新开窗口后验证(PowerShell / CMD):
echo $env:NEXTAI_API_KEY
echo %NEXTAI_API_KEY%
在代码里使用
OpenAI 兼容(Base URL 带 /v1)
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NEXTAI_API_KEY"],
base_url="https://www.nextai-code.com/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Anthropic 兼容(Base URL 不带 /v1,SDK 自动发送 x-api-key 头)
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["NEXTAI_API_KEY"],
base_url="https://www.nextai-code.com",
)
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
cURL
curl https://www.nextai-code.com/v1/chat/completions \
-H "Authorization: Bearer $NEXTAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "你好"}]}'
模型名以 GET /v1/models 返回为准。更多 SDK 见 安装 SDK。
API Key 的限制
每次请求都会校验以下限制,任一不满足即拒绝请求。完整错误文案与处理方式见 错误码。
状态
API Key 有四种状态:启用、已禁用、已过期、额度已用尽。只有「启用」状态可以调用,其余状态请求返回 401(额度已用尽返回 402)。可在列表中手动启用 / 禁用。
额度上限
- 不限制此密钥额度:该 API Key 不单独限额,消费直接从账户余额(或绑定的套餐)扣除。
- 设置可用额度:该 API Key 累计最多可花的额度。用完后请求返回
402,code为token_quota_exhausted。在控制台调高额度或改为不限额度后,API Key 自动恢复可用。
API Key 额度只限制「这个 API Key 最多能花多少」,实际扣款仍来自账户余额或套餐;账户余额不足时,即使 API Key 额度充足也会返回 402。
扣费方式(套餐)
API Key 可以绑定一个已购套餐,绑定后请求优先从套餐额度扣除。套餐用完后的行为由「套餐用完后」选项决定:
- 改用账户余额:继续从账户余额扣费
- 停止调用:返回
402,提示「套餐额度已用完,请续购」
过期时间
到达过期时间后 API Key 变为「已过期」,请求返回 401。要继续使用,先修改过期时间(或设为永不过期),再重新启用。
模型限制
设置后该 API Key 只能调用列表中的模型:
- 调用列表外的模型返回
403:「该令牌无权访问模型 xxx,请在控制台调整令牌权限」 GET /v1/models只返回这些模型
留空表示不限制,可用模型由分组决定。
IP 白名单
填写后只有来自这些 IP 的请求能使用该 API Key,其他来源返回 403:「您的 IP 不在令牌允许访问的列表中」。
- 每行一个 IP 地址,只支持单个 IPv4 / IPv6 地址,不支持 CIDR 网段(如
10.0.0.0/24会被忽略) - 按请求到达平台时的公网出口 IP 判断;本机在 NAT 或代理后面时,请填写公网出口 IP
分组
分组决定该 API Key 能用哪些模型,以及按哪个倍率计费。
- 分组已停用或不在你的账号可用范围内:返回
403(「令牌分组 xxx 已被禁用」/「分组 xxx 已被弃用」),请编辑 API Key 换一个可用分组 - 请求的模型不在当前分组:返回
404(「当前分组不支持模型 xxx,请切换分组或在控制台调整令牌分组。」)
常见问题
API Key 泄露了怎么办?
立即在「API Keys」页禁用或删除该 API Key,再新建一个替换;也可以用「重新生成密钥」换一个新值。对外部署的 API Key 建议设置额度上限和 IP 白名单,降低泄露损失。
返回 401「令牌无效或已过期」
逐项检查:
- 请求头格式为
Authorization: Bearer sk-xxx,Bearer后有一个空格 - API Key 完整复制,前后没有多余的空格或换行
- API Key 在控制台为「启用」状态,未过期、未被删除
- 鉴权头与协议匹配:Anthropic 用
x-api-key,Gemini 用x-goog-api-key或?key=,见 Base URL 总览
返回 402 额度不足
- 「该令牌额度不足…」:这个 API Key 的可用额度用完了,在控制台调高额度或改为不限额度
- 「余额不足,账户…」:账户余额不足,请充值
- 「套餐额度已用完,请续购」:绑定的套餐已用完,续购或改为「改用账户余额」
读不到环境变量
- 设置后需要重新打开终端(Windows
setx/SetEnvironmentVariable尤其如此),IDE 也要重启才能继承新变量 - macOS 写入
~/.zshrc后执行source ~/.zshrc - Python 用
os.environ["NEXTAI_API_KEY"],Node.js 用process.env.NEXTAI_API_KEY,变量名大小写需完全一致 - 在 Jupyter / 服务进程中使用时,变量需在进程启动前设置
API Key 后面能追加 -数字 吗?
不能。请直接使用控制台复制的完整 API Key,追加后缀会返回 403。