Skip to main content

查询积分收支流水

千问办公企业旗舰版开发者文档:查询积分收支流水。

认证方式见APP开发者文档 → 认证接入。
  • 接口:GET/api/openapi/app/v1/billings
  • 服务:Biz
  • operationId:appListBillingHistory

权限与归属

不使用客户 API Key,不接受 user_id、tenant_id 等身份参数。普通成员无需管理员权限。响应使用 Cache-Control: no-store。 金额 amount 是 Credits 十进制字符串(例如 "-1.2345"),不是 quota 接口的 minor 单位;保留正负号与精度。时间为 RFC 3339 字符串。成功响应直接返回对象,无 data 包装。

错误

401:未登录或身份缺失;403:身份/业务准入或上游拒绝;422:参数不合法;502:上游响应异常;503:服务未配置或上游不可用/限流;504:上游超时。失败不能解释为零消耗。未知或重复查询参数会被拒绝。

请求参数

参数类型默认值说明
sourcestringallall、qwenwork_web、desktop
此接口不支持游标,返回上游当前提供的流水集合,页面在前端对返回集合分页。

成功响应

{
  "items": [
    {
      "amount": "-1.2345",
      "created_at": "2026-10-18T01:00:00Z",
      "detail": {
        "title": "任务消耗"
      },
      "type": "对话",
      "source": "qwenwork_web",
      "session_id": "session-id"
    }
  ]
}
items 中包含 amount、created_at、detail.title、type;source、session_id 可缺省。type 透传上游,不将其限制为消耗/收入两种。金额可正、负或零,流水可能包含过期记录。

响应字段

字段类型必返说明
itemsarray<object>是上游当前提供的流水集合;不提供服务端分页游标。
items[].amountstring是Credits 十进制字符串,保留精度及正负号;不是 minor 单位。
items[].created_atstring是流水创建时间,RFC 3339。
items[].detailobject是流水详情。
items[].detail.titlestring是流水展示标题。
items[].typestring是上游流水类型,不限制为收入/消耗两种。
items[].sourcestring否流水来源,按实际响应返回。
items[].session_idstring否关联会话标识;非会话流水可能省略。