创建 API 令牌
约 446 字大约 1 分钟
2026-07-21
API 令牌用于让 Codex、Claude Code、OpenAI SDK、Cherry Studio、Cline、Roo Code 等客户端访问 NexAPI。
进入令牌管理
- 登录 NexAPI 控制台。
- 在左侧菜单点击“令牌管理”“API Key”或“Token 管理”。
- 点击“添加令牌”“新建令牌”或“Create API Key”。
填写令牌信息
| 配置项 | 建议填写 | 说明 |
|---|---|---|
| 令牌名称 | Codex、Claude Code、Cherry Studio | 用于区分不同客户端或项目 |
| 令牌分组 | 按使用场景选择 | 分组决定可用模型和计费策略 |
| 过期时间 | 长期使用可选永不过期 | 临时测试建议设置较短有效期 |
| 额度限制 | 按团队或个人预算设置 | 防止单个令牌意外消耗过多余额 |
| 模型限制 | 不熟悉时先保持默认 | 限制后只能调用指定模型 |
| IP 白名单 | 服务器环境可开启 | 本地网络变化较多时谨慎开启 |
令牌分组一定要选对
令牌分组会直接影响可调用模型。分组选错时，常见报错包括“模型不存在”“无可用渠道”“无权限访问该模型”或“当前令牌不可用”。
保存令牌
创建成功后，系统通常只会完整展示一次 API 令牌。请立即复制并保存到安全位置，例如密码管理器或本机环境变量。
export NEXAPI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"不要泄露 API 令牌
不要把 API 令牌写入公开仓库、截图、聊天群、Issue、构建日志或前端代码。发现泄露后，应立即在控制台删除旧令牌并重新创建。
下一步
令牌创建完成后，继续阅读：环境检查。