创建 API 令牌
API 令牌用于让 Codex、Claude Code、OpenAI SDK 等客户端访问 NexAPI。控制台中将它显示为“API 密钥”，本文档中的“API 令牌”“API Key”和“API 密钥”指的是同一项内容。
进入 API 密钥页
- 登录 NexAPI 控制台。
- 在左侧“常规”菜单中点击“API 密钥”。
- 进入页面后，可以按名称或 API 密钥筛选，并查看每个密钥的状态、额度、分组和模型限制。
新建 API 密钥
在 API 密钥页点击新建按钮，然后根据实际用途填写密钥信息。不同版本的按钮位置或名称可能略有不同，以当前控制台显示为准。
填写令牌信息
| 配置项 | 建议填写 | 说明 |
|---|---|---|
| 密钥名称 | Codex、Claude Code 或项目名 | 用于区分不同客户端或项目 |
| 密钥分组 | 按使用场景选择 | 分组决定可用模型和计费策略 |
| 过期时间 | 长期使用可选永不过期 | 临时测试建议设置较短有效期 |
| 额度限制 | 按团队或个人预算设置 | 防止单个令牌意外消耗过多余额 |
| 模型限制 | 不熟悉时先保持默认 | 限制后只能调用指定模型 |
| IP 白名单 | 服务器环境可开启 | 本地网络变化较多时谨慎开启 |
密钥分组一定要选对
密钥分组会直接影响可调用的模型。分组选错时，常见报错包括“模型不存在”“无可用渠道”“无权限访问该模型”或“当前令牌不可用”。
保存令牌
创建成功后，请点击 API 密钥旁的复制按钮，并保存到安全位置，例如密码管理器或本机环境变量。复制后不要在群聊或在线工具中粘贴测试。
export NEXAPI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"不要泄露 API 令牌
不要把 API 令牌写入公开仓库、截图、聊天群、Issue、构建日志或前端代码。发现泄露后，应立即在控制台删除旧令牌并重新创建。
下一步
令牌创建完成后，继续阅读：环境检查。