1. 注册并登录账号
打开本站注册页面，根据页面提示填写账号信息并完成注册。已有账号时直接前往登录页面。
1
进入注册页面
确认浏览器地址属于 www.codex789.com，不要在来源不明的页面填写账号信息。
2
完成账号信息
使用可长期访问的联系方式，并为账号设置独立密码。不要复用 API Key 作为登录密码。
3
登录控制台
登录成功后进入控制台，后续的余额、密钥、用量和调用记录都在控制台中管理。
2. 准备账户额度
调用模型前先查看账户余额。余额不足时，在控制台的账户或充值页面选择额度并按页面显示的方式完成支付。
以结算页面为准实际到账额度、活动、支付方式和订单状态以控制台实时展示为准。完成后返回账户页确认余额已经更新。
3. 创建 API Key
进入API 密钥页面，点击“创建密钥”。密钥用于接口认证，不等同于账号密码。
建议填写的密钥设置
| 设置项 | 建议 | 作用 |
|---|---|---|
| 名称 | 按项目或环境命名 | 便于区分测试、生产和不同应用 |
| 分组 | 选择包含目标模型的分组 | 决定当前密钥可以调用哪些模型 |
| 有效期 | 按项目周期设置 | 降低长期密钥泄露风险 |
| 额度 | 测试阶段设置较小上限 | 限制意外调用造成的消耗 |
| 访问限制 | 生产环境按需启用 | 限制模型或来源 IP |
立即妥善保存API Key 应存入环境变量或密钥管理工具。不要放进前端代码、截图、公开仓库、聊天记录或客户端安装包。
4. 确认模型代号与 Base URL
前往模型广场了解当前模型分类；在“API 密钥”页面点击创建密钥，可以查看对应分组和模型倍率。调用时请复制完整模型代号，不要根据展示名称自行拼写。
- 统一站点入口：
https://www.codex789.com - OpenAI 兼容 SDK Base URL：
https://www.codex789.com/v1 - 聊天请求路径：
/v1/chat/completions
密钥分组与模型不匹配时，即使模型代号正确，也可能出现“模型不存在”或无权限调用。
5. 发送第一次 API 请求
把 YOUR_API_KEY 和 MODEL_ID 替换为自己的密钥与模型代号。不要把真实密钥发给他人。
cURL
curl https://www.codex789.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{"role": "user", "content": "请用一句话确认接口已连接"}
]
}'请求成功后，响应中会包含模型生成内容和用量信息。接下来可以进入OpenAI 兼容 API 教程，查看 Python、Node.js 和流式输出接入方法。
6. 查看调用用量
返回控制台查看调用记录、Token 用量和扣费明细。建议分别为开发、测试和生产环境创建密钥，以便定位成本和异常请求。
- 测试请求是否产生对应调用记录。
- 模型代号是否与请求一致。
- 输入、输出用量和扣费是否符合预期。
- 失败请求是否带有可用于排查的错误信息。
7. 常见问题
| 现象 | 优先检查 |
|---|---|
401 或认证失败 | API Key 是否完整、有效，Authorization 是否使用 Bearer 格式 |
403 或无权限 | 密钥分组、模型限制、IP 限制与有效期 |
404 或模型不存在 | 请求路径是否带 /v1，模型代号是否属于当前分组 |
429 | 账户余额、密钥额度、请求频率和并发数 |
5xx 或超时 | 稍后重试、缩短输入、降低并发，并查看服务状态 |