GetAPIGetAPI.ONE API 接入教程：获取密钥与首次调用
从注册账号、选择模型到创建限制范围的 API 密钥、配置客户端并完成首次连接的完整路径。
从这里开始
首次使用 GetAPI.ONE，请先注册账号，选择模型及其支持的端点，再创建 API 密钥。已有密钥？可直接查看下面的 Python 或 Node.js 示例。发送请求前请确认当前价格。
开始前准备
- 只使用官方域名 https://www.getapi.one，并准备一个可以接收验证码的邮箱。
- 先确定要接入 Codex CLI、通过 CCSwitch 接入兼容的 Codex 目标，还是使用自己的 API 客户端。
- 准备好私有密码管理器或环境变量存储位置。不要把真实密钥放进公开工单、截图或代码仓库。
1. 创建并进入账号
- 打开注册页，设置用户名和 8–20 位密码，再填写邮箱。
- 发送并填写邮箱验证码，阅读并同意页面链接的用户协议与隐私政策，然后创建账户。
- 使用用户名或邮箱和密码登录。成功后应进入概览页。
2. 核对余额、端点与模型
- 在发送可能计费的请求前，确认账号有可用余额或适用套餐。
- 打开模型目录。选择明确列出客户端所需端点的模型；不要仅凭模型名称推断协议支持。
- 使用前立即查看实时价格，并核对当前模型、分组、计价模式与计费单位，因为可用性和价格可能变化。
3. 创建受限 API 密钥
- 进入“API 密钥”，选择“创建 API 密钥”，并用客户端或项目名称为密钥命名。
- 选择所需分组，并设置适合本次接入的明确过期时间和额度。只有确实需要时再配置高级访问限制。
- 保存后从密钥列表复制到私有存储。GetAPI.ONE 会保留可管理的列表项，之后仍可再次复制密钥。
4. 连接一个客户端
只选择与你的客户端匹配的路径。Codex 自定义 Provider 使用 Responses 协议和 ONE Base URL https://www.getapi.one/v1。直接调用 API 时必须使用明确声明的端点，不能盲目拼接路径。
5. 验证并继续
- 成功是指所选客户端收到有效响应，并且 GetAPI.ONE 控制台记录到该请求；仅通过本地语法检查不等于真实调用成功。
- 遇到 401 时重新复制 ONE 密钥，确认密钥已启用且与 ONE 地址配套；遇到 404 时核对客户端要求的准确端点或 /v1 Base URL。
- 遇到模型不存在时，选择密钥分组可见且端点兼容的模型；遇到额度、限速、网络或上游错误时，先保存时间和请求标识再排查。