切换深色模式
快速开始
完成下面四步，即可接入 OnprsCodexApi。全程只需要控制台账号、一个 API Key、可用模型名和正确的协议端点。
1. 登录控制台
打开 OnprsCodexApi 控制台。尚未注册时，按页面当前开放的注册方式完成账号创建；注册方式和验证要求可能随运营配置变化。
登录后先进入个人中心，确认邮箱和账号状态正常。不要与他人共用登录密码。
2. 创建 API Key
进入 API Keys，为当前设备或应用创建独立 Key。名称建议包含用途和环境，例如 codex-laptop 或 team-app-prod。
创建时选择与你要调用的平台、模型和计费方式匹配的分组。完整步骤见创建与管理 API Key。
Key 只展示给需要使用它的程序
API Key 不是登录凭据。不要把完整 Key 发给客服、写入 Git、截图或前端代码。
3. 确认模型和协议
进入可用渠道确认分组当前可用模型，再根据客户端选择协议：
| 使用方式 | Base URL | 主要生成端点 |
|---|---|---|
| OpenAI Chat Completions | https://api.onprs.top/v1 | /chat/completions |
| OpenAI Responses / Codex | https://api.onprs.top/v1 | /responses |
| Anthropic / Claude Code | https://api.onprs.top/v1 | /messages |
| Google GenAI / Gemini | https://api.onprs.top | /v1beta/models/{model}:generateContent |
协议完整边界见协议与端点。
4. 发送最小请求
先设置两个临时变量：
bash
export ONPRS_API_KEY="sk-your-api-key"
export ONPRS_MODEL="replace-with-an-available-model"powershell
$env:ONPRS_API_KEY="sk-your-api-key"
$env:ONPRS_MODEL="replace-with-an-available-model"然后按发送第一条请求中的任一协议示例测试。
成功判据
- HTTP 状态为
200。 - 返回正文中有模型输出，而不是空字符串或错误对象。
- 响应头或正文中可找到请求 ID 时予以保留。
- 用量记录稍后能看到对应请求、模型和费用。
下一步：配置常用客户端。