Skip to main content

查询当前用户个人余额

千问办公企业旗舰版开发者文档:查询当前用户个人余额。

认证方式见APP开发者文档 → 认证接入。
  • 接口:GET/api/openapi/app/v1/quota
  • 服务:Biz
  • operationId:consoleGetPersonalQuota
  • 范围:当前用户个人额度。
查询当前用户的个人总额度、已用额度和剩余额度,不汇总企业余额,不经过 Session 转发。

权限与归属

普通用户可以查询本人额度,不要求管理员配额管理权限。

请求参数

无路径参数、查询参数或请求体。用户、组织与团队均来自可信身份;不能传入 user_id、team_id 查询他人额度,任何查询参数均返回 422。 调用示例:
const response = await appRequest('/api/openapi/app/v1/quota', {
  method: 'GET',

  cache: 'no-store',
});
if (!response.ok) throw new Error('余额暂不可用');
const quota = await response.json();

成功响应

HTTP 200,响应体直接返回以下对象,不包裹 data;响应头为 Cache-Control: no-store。
{
  "allowance_minor": "1000000",
  "used_minor": "250000",
  "remaining_minor": "750000"
}
字段类型必填含义
allowance_minorstring是个人总额度,非负十进制整数字符串
used_minorstring是个人已用额度,非负十进制整数字符串
remaining_minorstring是个人剩余额度,max(allowance_minor - used_minor, 0)
1 Credit = 10000 minor units。上述示例分别为 100、25、75 Credits。使用字符串保留整数精度,避免直接转换为 JavaScript Number 后丢失大整数精度。

错误与展示

HTTP 状态含义调用方处理
401未登录或可信用户、组织、团队身份不完整按认证接入处理
403入口身份或 audience 校验拒绝核对当前 员工登录入口
422携带查询参数,personal_quota_query_invalid去掉查询参数
503配额缺失、上游失败或超时等,personal_quota_unavailable显示“余额暂不可用”,不沿用旧余额
真实零余额仍返回 HTTP 200 和 remaining_minor: "0"。查询失败不表示零余额或无限额度。余额查询只用于展示,不预扣额度,也不替代 Session 在创建会话、后续消息和定时执行时的后台校验。