GetAPIGetAPI.ONE
创建并保护 GetAPI.ONE API 密钥
创建有名称、有范围的密钥，选择分组、过期时间和额度，在源码之外保存，并完成验证与安全撤销。
开始前准备
- 登录 GetAPI.ONE，并确认可以进入控制台。
- 确认账号有可用余额或适用套餐。
- 确定这个密钥只供哪个客户端或项目使用，以及私有环境变量存放位置。
创建密钥
- 从控制台导航进入“API 密钥”，点击“创建 API 密钥”。
- 填写能够识别客户端和环境的名称；名称中不要放入密钥本身。
- 选择预期模型和端点所需的分组。
- 设置一个密钥、明确的过期时间和符合预期用量的额度；仅在客户端需要时配置高级限制。
- 保存更改并返回密钥列表。
复制并保存密钥
创建后，列表会显示密钥名称、脱敏密钥、分组、状态和管理操作。GetAPI.ONE 的密钥不是只显示一次：之后仍可从密钥列表再次复制并继续管理。
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"将密钥与 ONE 地址配套
| 用途 | 值 |
|---|---|
| 站点 / API Origin | https://www.getapi.one |
| Codex / CCSwitch Base URL | https://www.getapi.one/v1 |
| 凭据 | 从 GetAPI.ONE 密钥列表复制 |
在不泄露密钥的前提下验证
- 配置一个客户端，或使用直接请求指南，并把占位模型替换为目录中端点兼容的模型。
- 只发送你确实准备计费的最小请求；制作本指南时未发送模型请求。
- 确认收到有效响应，并检查控制台请求或使用记录；保存诊断输出前遮盖密钥。
错误、轮换与撤销
- 401 / Unauthorized：重新复制密钥，移除意外空格，确认密钥已启用并与 ONE 地址配套。
- 模型不存在或无权访问：确认密钥分组可见该模型，并且模型声明支持客户端所用端点。
- 额度或过期错误：扩大限制前先检查密钥额度和过期时间，同时核对账号余额与速率限制。
- 怀疑泄露：禁用或删除受影响密钥，创建最小范围的新密钥，更新客户端，并确认旧密钥不能再用。