成员自助门户

登录、创建与撤销密钥、查看预付余额和用量、复制网关 Base URL，以及修改密码。

MEMBER 门户是运行在 Admin 主机上的会话鉴权自助控制台，已经替代退役的 JSON 鉴权 API；系统没有公开注册接口。

成员登录前

运维必须创建 ACTIVE MEMBER 用户，设置限制与模型权限，并发放预付额度。见Admin 控制台指南。门户不销售额度，也不接收付款；充值由运维执行。

登录

打开：

https://<admin-host>/my/login/

使用成员邮箱与密码登录。同一邮箱或客户端 IP 失败十次会锁定 15 分钟；会话最长八小时。INACTIVE 或 SUSPENDED 用户会被拒绝。

门户区域

单页 /my/ 使用锚点展示：

  • 概览——当前预付余额、套餐、活动密钥数、总请求数与总 token。
  • 快速开始——部署专属的兼容 OpenAI Base URL，以及 curl/Python/JavaScript 示例。运维必须按配置所示把 CORDY_GATEWAY_BASE_URL 传给 Admin 服务。
  • 余额——最近最多 100 条充值、消费、调整与退款流水。
  • API Keys——创建、查看与撤销自己的密钥。
  • 用量——汇总及最近 50 次请求；运维把 ADMIN_LANGFUSE_TRACE_URL_TEMPLATE 传给 Admin 服务后可显示 Langfuse 链接。
  • 账户——邮箱、套餐、状态与密码修改。

创建密钥

  1. 打开 API Keys。
  2. 输入可选名称。
  3. 选择创建 Key。
  4. 立即复制 wnx_ 明文；显示一次后会从会话中移除。

部署默认每位用户最多三条密钥记录，运维可修改平台设置。计数包含已撤销与未激活记录，因此撤销密钥不会释放创建名额。门户创建的密钥继承你的默认限速与 token 配额，并以推理作用域起步。程序客户端需要调用账户接口时，请让运维添加 balance。

撤销时点击对应行的撤销并确认。对该密钥而言撤销不可逆；需要时重新创建。

发起请求

复制“快速开始”中的 Base URL，通常以 /v1 结尾。使用刚复制的密钥：

export CORDY_BASE_URL="https://gateway.example.com/v1"
export CORDY_API_KEY="wnx_..."

curl -sS "$CORDY_BASE_URL/models" \
  -H "Authorization: Bearer $CORDY_API_KEY"

从返回结果选择模型 ID，再按客户端接入操作。网关支持纯文本对话与嵌入；对话中的图片与音频部分会被拒绝。

区分余额与配额

  • 预付余额是账户级金额，每个已结算请求按计算出的上游成本扣减；余额为零返回 HTTP 402。
  • Token 配额属于单把密钥；即使账户仍有余额，耗尽后也返回 HTTP 429。
  • 限速同样属于单把密钥，按每分钟请求数计算。

门户通过 Django 会话显示账户汇总。API 账户接口则另行要求密钥拥有 balance 作用域。

修改密码与退出

在“账户”中输入当前密码与至少八个字符的新密码。修改成功后当前会话保持登录。使用页头的退出；退出仅接受 POST。