文档中心

TRAE CN

用量管理

查询成员的个人用量限额

查询指定成员当前的用量限额，包括 TRAE 内置模型和企业内置模型的成员个人限额配置。

所需权限

quota:read

请求说明

请求参数

请求头参数

Header 参数	是否必填	描述
Authorization	是	固定取值为 Bearer {access_token}。关于如何获取访问令牌，参考鉴权。
Content-Type	是	固定取值为 application/json。

请求体参数

参数	类型	是否必填	默认值	描述
emails	string[]	条件必填	-	目标成员的邮箱列表。与 user_ids 至少传入一个。成员的邮箱可以通过 “获取成员列表” 接口获取。
user_ids	string[]	条件必填	-	目标成员的 ID 列表。与 emails 至少传入一个。成员的 ID 可以通过 “获取成员列表” 接口获取。

提示

单次请求支持同时传入 emails 和 user_ids。系统会根据邮箱或用户 ID 解析成员，并对重复成员自动去重。去重后，单次请求最多支持传入 50 个成员。

响应参数

该接口独有的响应参数如下。通用响应参数参考此文档。

参数	类型	描述
trae_model_quota_type	string	企业当前对 TRAE 内置模型采用的用量计算模式。取值： token：按 Token 计，仅旧企业版套餐使用。 price：按金额计（单位：元），仅新企业版套餐使用。
pooling_enabled	bool	企业当前是否已启用 “共享额度池（池化）” 功能。该功能仅对新旗舰版套餐和 TRAE 内置模型生效。详情参考共享额度池。
quota_granularity	string	企业当前的额度配置粒度。取值： all：为全部模型设置一个总额度。 per_model：为每个模型单独设置额度。
users	array	已查询到的成员用量限额信息。具体字段说明参考设置成员的用量限额。
not_found_users	string[]	未查询到或不属于当前企业的成员标识。

示例

请求示例

响应示例

错误码

若该接口的请求返回错误码，参考错误码文档进行排查。

最近更新时间：2026.10.10 17:34:31

这个页面对您有帮助吗？

有用

无用