接口介绍
配置与配额接口用于查询实例配额和管理用户配置。共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 | 服务内部错误，可有限重试。 |