第一步：登录并进入控制台

注册并登录后，在顶部导航进入「控制台」。密钥、余额、用量记录都在这里管理。

第二步：创建 API 密钥

  1. 打开「API 密钥」页面。
  2. 点击「添加密钥」，填写一个容易识别的备注（例如：本地开发 / 生产环境）。
  3. 密钥创建后只完整显示一次，请立即保存到服务端环境变量或密码管理器中。
  4. 不要把密钥提交到代码仓库、截图分享，或在网页端代码中写死。

第三步：选择一个当前可用的模型

打开首页「实时价格」区域：只有标记为 Live settlement（实时结算） 的模型才可调用；标记为「参考」的行仅用于和官方价格对比，不代表可调用。 也可以直接请求模型列表接口：

curl https://47.237.177.122/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

第四步：发送第一个请求

复制返回的模型 ID，用 Chat Completions 做一次最小验证：

curl https://47.237.177.122/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "刚刚复制的模型 ID",
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回 200 且包含 choices 字段，即代表从网关到上游的整条链路正常。

第五步：接入你的客户端

  • Claude Code：参考《客户端配置指南》
  • Codex CLI：参考《客户端配置指南》
  • 其他 OpenAI 兼容应用：把 baseURL 设置为 https://47.237.177.122/v1，apiKey 填你的密钥

常见报错速查

  • 401：密钥错误或已失效，重新复制并检查请求头。
  • 403：余额不足或密钥无权限，先充值或检查额度与分组访问。
  • 429：触发限流，稍后按指数退避重试，详见《故障排查指南》。
  • 模型不可用：确认模型 ID 来自 /v1/models 且标记为 Live settlement，并阅读响应体中的具体错误信息。