跳转到主要内容
旧版系统令牌(AccessToken)已于 2026-11-09 停用。
  • 继续使用旧令牌会返回 HTTP 401,code 为 ACCESS_TOKEN_LEGACY_RETIRED。
  • 按下文创建个人访问令牌,把脚本里的旧令牌换成新令牌即可;接口地址、请求方式和返回字段都不变。

创建个人访问令牌

个人访问令牌不是调用模型用的 API Key:它只用来访问账户管理接口,按创建时勾选的权限工作。生产环境把它放在服务端密钥管理系统或环境变量中,不要下发到浏览器或客户端 App。
1

打开个人访问令牌

登录控制台,进入个人设置 →「安全与访问」→「个人访问令牌」,点击新建。
2

填写名称并勾选权限

名称写清用途,例如「余额告警」。只勾选脚本需要的权限:
  • 查询余额:profile:read
  • 同时导出调用日志:再勾选 usage:read,见日志查询 API
  • 管理 API Key:按需勾选 api_key:read、api_key:write、api_key:reveal,见令牌管理 API
还可以为令牌设置 IP 白名单和过期时间。
3

复制并保存

令牌以 nap_ 开头,只在创建时显示一次,之后无法再次查看,请立即复制到安全位置。
修改密码、两步验证或通行密钥后,所有个人访问令牌都会被撤销。
  • 需要重新创建令牌,并更新所有使用旧令牌的脚本。
  • 每个账户最多可创建 20 个个人访问令牌。
  • 不要在代码仓库、前端页面、日志、截图或工单里暴露完整令牌。向技术支持排查时,只提供请求时间、HTTP 状态码、返回的 code 和已打码的令牌片段。

接口信息

请求说明

请求 Headers

请求参数

此接口不需要 Query 参数,也不需要请求体。

响应说明

成功响应示例

核心响应字段

接口可能随账户状态返回更多字段。开发时请只依赖业务需要的核心字段,并允许响应中出现未知字段,避免因为新增字段导致解析失败。

额度与金额计算

接口返回的 quota 单位是「额度」,不是直接的美元金额。当前余额展示按以下规则换算: 也就是说,50 万额度约等于 1 USD。如果接口返回 quota: 24997909,用户当前可用余额约为 50.00 USD。 余额展示可以按上述公式计算;模型实际扣费仍要以当前模型价格、令牌分组、调用日志和控制台展示为准,计费规则见计费说明。 生产告警建议同时保存原始 quota 和换算后的美元金额,避免后续排查时丢失精度。

代码示例

以下示例从环境变量 LAOZHANG_ACCESS_TOKEN 读取个人访问令牌。原来用旧版 AccessToken 的脚本,只需把这个变量的值换成新令牌。
建议保留 --compressed,它让 cURL 自动解压 gzip 响应。少了这个选项,终端可能显示乱码,jq 也可能报 Invalid numeric literal。

错误响应

认证失败

认证失败时返回 HTTP 401,响应体里的 code 说明原因。例如仍在使用旧令牌时:
脚本不要只看状态码,要检查响应里的 success 是否为 true。

响应乱码或 jq 报错

如果 cURL 返回乱码,或 jq 报 Invalid numeric literal,通常是 gzip 响应没有被解压。请确认命令包含 --compressed。

监控接入建议

需要在余额不足前收到提醒时,用本接口做定时检查。下面的脚本在剩余金额低于阈值时以状态码 1 退出:
把它交给 cron 或监控系统,每 10–30 分钟运行一次,非零退出时发送通知,例如:
cron 默认不读取你的 shell 环境变量,需要在脚本或 crontab 中提供 LAOZHANG_ACCESS_TOKEN。接入时注意:
  • 用环境变量或密钥管理服务保存 LAOZHANG_ACCESS_TOKEN
  • 设置合理超时时间,例如 10 秒
  • 避免高频轮询;一般余额监控不需要秒级请求
  • 告警里记录 quota、换算后的 remaining_usd、used_quota、request_count、请求时间和 HTTP 状态码
  • 不要在日志中记录完整 Authorization、access_token 或账户敏感字段
  • 修改密码、两步验证或通行密钥后,令牌会被撤销,告警脚本会开始返回 401;改完安全设置记得换新令牌

相关文档