管理接口说明

除了调用模型，你还可以通过管理接口以编程方式查询账户信息、创建和管理令牌，适合需要为自己的用户自动分发密钥的场景。

认证方式

管理接口不使用 sk- 令牌，而是使用系统访问令牌：

1. 登录控制台，进入 个人设置，生成系统访问令牌（重新生成后旧的立即失效）。
2. 在个人设置页面查看自己的 用户 ID。
3. 请求时携带以下两个请求头：

请求头	值
Authorization	Bearer <系统访问令牌>
New-Api-User	你的用户 ID，必须与访问令牌所属用户一致

export VIP_ACCESS_TOKEN="你的系统访问令牌"
export VIP_USER_ID="123"

curl https://vip.zen-ai.top/api/user/self \
  -H "Authorization: Bearer $VIP_ACCESS_TOKEN" \
  -H "New-Api-User: $VIP_USER_ID"

系统访问令牌拥有账户的完整权限

它可以查看和修改你的全部令牌。只能在服务端使用，不要写进前端代码、不要分享给他人；泄露后请立即在个人设置中重新生成。

响应格式

管理接口统一返回：

{
  "success": true,
  "message": "",
  "data": {}
}

请以 success 判断是否成功（部分业务错误的 HTTP 状态码也是 200），失败原因在 message 中。

额度单位

管理接口中的 quota、remain_quota、used_quota 等字段使用内部额度单位：500000 = 1 美元（1 刀）。例如 remain_quota: 5000000 表示 10 刀。

调用限制

• 管理接口不支持浏览器跨域调用，请在服务端发起请求，本站文档中的这些接口不提供在线调试。
• 接口列表：

方法	路径	说明
GET	/api/user/self	获取当前用户信息与余额
GET	/api/user/models	获取当前用户可用的模型
GET	/api/token/	分页获取令牌列表
GET	/api/token/search	按名称或密钥搜索令牌
GET	/api/token/{id}	获取单个令牌
POST	/api/token/	创建令牌
PUT	/api/token/	更新令牌 / 启用禁用
DELETE	/api/token/{id}	删除令牌

令牌对象

令牌相关接口返回的令牌对象字段如下：

idinteger

令牌 ID。

keystring

密钥，不含 sk- 前缀，使用时需拼接为 sk-{key}。

namestring

令牌名称。

statusinteger

状态：1 启用、2 禁用、3 已过期、4 额度已用尽。

groupstring

所属分组，空字符串表示使用用户默认分组。

remain_quotainteger

剩余额度（500000 = 1 刀）。

used_quotainteger

已用额度。

unlimited_quotaboolean

是否无限额度。

expired_timeinteger

过期时间（Unix 秒），-1 表示永不过期。

model_limits_enabledboolean

是否启用模型限制。

model_limitsstring

允许的模型，英文逗号分隔。

allow_ipsstring

允许访问的 IP，每行一个。

created_timeinteger

创建时间（Unix 秒）。

accessed_timeinteger

最近使用时间（Unix 秒）。