腾讯云数据库 AI 服务 配置与配额(Metadata)

这篇说说腾讯云记忆服务配置与配额接口,包括获取实例配额、获取和设置用户配置共3个POST接口,并列出请求示例、响应字段及错误码说明。 获取实例配额:返回当前与最大用户数、团队数、Agent数及记忆条数等资源限额。 获取/设置用户配置:通过user_id获取或修改用户的default_model等配置项,支持键值对更新。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、接口介绍

配置与配额接口用于查询实例配额和管理用户配置。共3个接口:

接口 方法 功能
/v3/config-quota/instance POST 获取实例配额
/v3/config-quota/user-config/get POST 获取用户配置
/v3/config-quota/user-config/set POST 设置用户配置

二、获取实例配额

获取当前实例的资源配额信息。

POST /v3/config-quota/instance

三、请求参数

无额外请求参数。

四、请求示例

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/config-quota/instance \\ -d '{}'

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "max_users":100, "max_teams":20, "max_agents":50, "max_memory_count":100000, "current_users":15, "current_teams":5, "current_agents":12, "current_memory_count":3420 }}

六、响应 data

字段 类型 说明
max_users int 最大用户数
max_teams int 最大团队数
max_agents int 最大 Agent 数
max_memory_count int 最大记忆条数
current_users int 当前用户数
current_teams int 当前团队数
current_agents int 当前 Agent 数
current_memory_count int 当前记忆条数

七、获取用户配置

获取指定用户的配置信息。

POST /v3/config-quota/user-config/get

八、请求参数

字段 类型 必选 说明
user_id string 是 用户 ID

九、请求示例

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/config-quota/user-config/get \\ -d '{"user_id":"user-123"}'

十、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "user_id":"user-123", "config":{ "default_model":"gpt-4o", "max_tokens":4096 } }}

十一、响应 data

字段 类型 说明
user_id string 用户 ID
config object 用户配置键值对

十二、设置用户配置

设置指定用户的配置项。

POST /v3/config-quota/user-config/set

十三、请求参数

字段 类型 必选 说明
user_id string 是 用户 ID
config object 是 配置键值对

十四、请求示例

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/config-quota/user-config/set \\ -d '{"user_id":"user-123","config":{"default_model":"gpt-4o"}}'

十五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "user_id":"user-123", "updated":true }}

十六、响应 data

字段 类型 说明
user_id string 用户 ID
updated bool 配置是否更新成功

十七、错误码

HTTP 状态码 错误信息 说明
400 request: Invalid input 请求参数不合法。
401 Missing or invalid Authorization header Bearer API Key 缺失或格式不正确。
 Missing x-tdai-service-id header 请求头中未携带 x-tdai-service-id。
404 USER_NOT_FOUND 指定用户不存在。
500 Internal error 服务内部错误,可有限重试。
赞 (0)
上一篇 4天前
下一篇 4天前