管理接口让你可以在自己的脚本或系统里操作 ZeroCat 账户，例如：
  • 查询账户信息、余额和可用模型；
  • 创建、查询、修改、删除 API 密钥；
  • 查询调用日志和额度统计；
  • 查询充值记录和异步任务。
本节只列出普通用户可以调用的接口，所有接口都只能访问你自己的数据。

​
个人访问令牌

调用管理接口需要个人访问令牌，不是调用模型用的 API 密钥。

​
创建访问令牌

  1. 登录 ZeroCat，点击左侧导航「安全与访问」。
  2. 在「会话与访问」中找到「访问令牌」，点击「创建访问令牌」。
  3. 填写令牌名称，选择过期时间，勾选需要的权限。
  4. 按提示完成安全验证（密码、两步验证码或 Passkey）。
  5. 复制生成的令牌（以 nap_ 开头）。令牌只显示一次，请立即妥善保存。
每个令牌只拥有创建时勾选的权限。下文每个接口的说明里都标注了所需的作用域，例如 api_key:read 对应权限表中的「API 密钥 → 查看」。完整的权限说明见 个人访问令牌。
  • 只勾选脚本真正需要的权限。例如只查余额和日志的脚本，勾选「个人资料 → 查看」和「用量 → 查看」就够了。
  • 访问令牌请像密码一样保管，不要提交到代码仓库。
  • 访问令牌不能用来调用模型，也不要填进 AI 客户端。
  • 怀疑泄露时，在「访问令牌」列表中撤销该令牌，使用它的脚本会立即失效。

​
访问令牌与 API 密钥的区别

​
请求格式

  • 地址：https://zero.cat
  • 请求头：Authorization: Bearer <你的访问令牌>

​
示例：查询当前用户信息

需要作用域 profile:read（个人资料 → 查看）。

​
示例：查询 API 密钥列表

需要作用域 api_key:read（API 密钥 → 查看）。
列表中的密钥是打码的。需要完整密钥时，调用 获取完整 API 密钥，这需要额外勾选「API 密钥 → 查看完整密钥」。

​
响应格式

管理接口通常返回如下结构：
请先检查 success 是否为 true。为 false 时，message 中是错误原因。 常见的鉴权错误：
返回结果中的额度字段（如 quota、used_quota、remain_quota）是内部额度单位，与页面上显示的金额之间的换算以控制台为准。

​
不需要访问令牌的接口

以下接口不需要个人访问令牌：

​
只能在控制台进行的操作

创建、修改、撤销访问令牌，以及登录会话管理，只能在网页控制台中操作，不能用访问令牌调用。

​
分页参数

列表类接口使用 p（页码，从 1 开始）和 page_size（每页条数，默认 10，最大 100）分页，返回结果的 data 中包含 page、page_size、total 和 items。