a13nDocs
API 参考用量

列出成员用量

GET/api/v1/usage/members

认证与授权

认证与授权Bearer <token>

工作空间 API 密钥（a13n_...）

传递位置: header

查询参数

start*Start
格式date-time
end*End
格式date-time
principal_id?|

按 Run 执行身份筛选；需要工作空间管理员权限。

limit?Limit
范围1 <= value <= 100
默认值50
cursor?|null

请求头参数

X-Workspace-ID?|

登录会话作用的工作空间 ID，登录会话必须提供。API 密钥作用于自身工作空间，无需提供；禁止指定其他工作空间。

响应体

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/usage/members?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z"
{  "items": [    {      "kind": "user",      "name": "string",      "principal_id": "string",      "runs": {        "average_duration_seconds": 0,        "runs": 0      },      "status": "active",      "usage": {        "cache_hit_rate": 0,        "cache_read_tokens": 0,        "cost": "string",        "input_tokens": 0,        "output_tokens": 0,        "requests": 0,        "unpriced_requests": 0      }    }  ],  "next_cursor": "string"}