获取与配置 API Key

调用 NextAI Code 的所有模型接口都需要 API Key。最短路径:

  1. 登录 https://www.nextai-code.com,进入控制台「API Keys」页(/console/keys),点击「创建新密钥」。
  2. 复制以 sk- 开头的 API Key,写入环境变量 NEXTAI_API_KEY。
  3. 以 https://www.nextai-code.com/v1 为 Base URL 发起请求。
BASH
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

当前终端临时生效:

BASH
export NEXTAI_API_KEY="YOUR_API_KEY"

永久生效(按你使用的 shell 选择文件):

BASH
# 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

验证:

BASH
echo $NEXTAI_API_KEY

Windows

PowerShell,当前窗口临时生效:

POWERSHELL
$env:NEXTAI_API_KEY = "YOUR_API_KEY"

永久写入用户环境变量(需重新打开终端才能读到):

POWERSHELL
[Environment]::SetEnvironmentVariable("NEXTAI_API_KEY", "YOUR_API_KEY", "User")

CMD 永久写入:

CMD
setx NEXTAI_API_KEY "YOUR_API_KEY"

新开窗口后验证(PowerShell / CMD):

POWERSHELL
echo $env:NEXTAI_API_KEY
CMD
echo %NEXTAI_API_KEY%

在代码里使用

OpenAI 兼容(Base URL 带 /v1)

PYTHON
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 头)

PYTHON
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

BASH
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。

相关文档