读取当前用户按分组和模型聚合的用量流

本地契约说明

路由：GET /api/data/flow/self

注册处理器：github.com/QuantumNous/new-api/controller.GetUserFlowQuotaDates。

消费方：web_vue。

鉴权：登录用户或更高角色。需要 Dashboard access token；精确 User/Admin/Root 边界以当前 Router middleware 为准。

字段状态：controller-confirmed-dashboard-flow。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。

页面/功能：个人仪表盘流量/分组分析读取当前用户数据。

前端传参：必传正数 start_timestamp、end_timestamp，时间跨度最多 30 天。

前端展示：FlowQuotaData 数组，包含 token_id/token_name、use_group、model_name、token_used、count、quota。

调试：使用本操作的 x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

管理端业务响应。HTTP 200 不代表业务成功，必须检查 success。

Bodyapplication/json

示例

{
    "success": true,
    "message": "",
    "data": [
        {
            "token_id": 7,
            "token_name": "debug-key",
            "use_group": "default",
            "model_name": "gpt-example",
            "token_used": 2400,
            "count": 12,
            "quota": 100000
        }
    ]
}

🟠401

🟠403

读取当前用户按分组和模型聚合的用量流

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明