You need to enable JavaScript to run this app.
文档中心
AI 原生 BaaS 平台 Supabase 版

AI 原生 BaaS 平台 Supabase 版

复制全文
下载 pdf
大模型访问管理
DescribeBaasAIUserSummaries
复制全文
下载 pdf
DescribeBaasAIUserSummaries
调用 DescribeBaasAIUserSummaries 接口查询访问大模型功能的模型使用汇总情况。​
请求类型​
同步请求。​
注意事项​
该接口仅能用于操作使用 Supabase 引擎的 Workspace(工作区)。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
WorkspaceId​
String​
是​
vivid-onion-1122****​
Workspace 的 ID。​
BranchId​
String​
是​
br-dandy-cusk-d7b1****​
分支的 ID。​
Offset​
Integer​
否​
2​
分页查询起始,可取大于等于 0 的整数值,默认值为 0。​
Limit​
Integer​
否​
5​
分页查询数量,可取大于等于 1 的整数值,默认值为 10。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
Total​
Integer​
4​
符合查询条件的用户总数。​
UserSummaryItems​
请参见返回示例。​
多个用户的模型使用汇总情况列表。​
​
BaasAIUserSummaryItem​
​
参数​
类型​
示例值​
描述​
CreateTime​
String​
2026-05-20T06:48:15Z​
用户的创建时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ssZ。对应于 auth.users.create_at。​
CustomQuota​
Object of BaasAIModelQuota​
请参见返回示例。​
用户的自定义限额。​
Email​
String​
test1@test.com​
用户邮箱,对应于 auth.users.email。​
LastSignInTime​
String​
2026-07-20T18:48:15Z​
用户最近登录时间,用户的创建时间(UTC 时间)。格式为 yyyy-MM-ddTHH:mm:ssZ。对应于 auth.users.last_sign_in_at。​
Phone​
String​
12345678910​
用户电话,对应于 auth.users.phone。​
​
QuotaCustomized​
Boolean​
true​
是否自定义了限额。取值:​
  • true:是。​
  • false:否。​
Usage​
Object of BaasAIModelUsage​
请参见返回示例。​
用户的模型用量统计。​
UserId​
String​
e0021ade-c4f4-43a8-9678-dc99a6b5****​
用户 ID,对应于 auth.users.id。​
UserName​
String​
TestUser​
用户名称,可能是邮箱或电话。​
说明​
如未设置,则返回空。​
​
BaasAIModelQuota​
​
参数​
类型​
示例值​
描述​
DailyImageLimit​
Long​
300​
每天的图片生成限额。​
说明​
-1表示不限量。​
DailyTokenLimit​
Long​
10000​
每天的 Token 限额。​
说明​
-1表示不限量。​
​
BaasAIModelUsage​
​
参数​
类型​
示例值​
描述​
TotalImages​
Long​
1000​
累计生成的图片数量。​
TotalTokens​
Long​
12341245245​
累计的 Token 用量。​
LastDailyImages​
Long​
​
最近一天的图片用量​
LastDailyTokens​
Long​
4338​
最近一天的 Token 用量。​
​
示例​
请求示例​
​
POST /?Action=DescribeBaasAIUserSummaries&Version=2025-10-01​
Content-Type: application/json​
Host: aidap.cn-beijing.volcengineapi.com​
X-Date: 20251001T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20251001/cn-beijing/aidap/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"WorkspaceId": "vivid-onion-1122****",​
"BranchId": "br-dandy-cusk-d7b1****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260707142930C97D74BE690D08749574-e73fe6",​
"Action": "DescribeBaasAIUserSummaries",​
"Version": "2025-10-01",​
"Service": "aidap",​
"Region": "cn-beijing"​
},​
"Result": {​
"Total": 2,​
"UserSummaryItems": [​
{​
"CreateTime": "",​
"CustomQuota": {​
"DailyTokenLimit": -1​
},​
"Email": "",​
"Phone": "",​
"QuotaCustomized": true,​
"Usage": {​
"LastDailyTokens": 0,​
"TotalTokens": 0​
},​
"UserId": "service_role:system",​
"UserName": "系统管理员"​
},​
{​
"CreateTime": "2026-05-20T06:48:15Z",​
"Email": "test1@test.com",​
"Phone": "",​
"QuotaCustomized": false,​
"Usage": {​
"LastDailyTokens": 0,​
"TotalTokens": 0​
},​
"UserId": "61559718-fce5-4fdb-bf2e-26e33f06****",​
"UserName": ""​
}​
]​
}​
}​
​
错误码​
更多详情,请参见错误码。​
最近更新时间:2026.08.25 12:34:59
这个页面对您有帮助吗?
有用
有用
无用
无用