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