程序化管理 API Key
使用访问令牌，通过接口查询、创建、更新和删除 API Key。
需要在应用中自动管理 API Key 时，可按本指南开始接入。仅需调用模型或配置 SDK，请参阅API Key 与认证。
获取访问令牌
在个人资料页面的“安全”区域创建访问令牌，用于管理所属用户的 API Key。
访问令牌与模型调用 API Key 用途不同：管理接口使用访问令牌，模型接口使用 API Key，不要混用。
发起第一个管理请求
将 your-user-token 替换为访问令牌，查询 API Key 列表：
curl 'https://api.agtcloud.cn/api/token/?p=1&size=20' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-user-token'请求成功后，从 data.items 中找到目标 Key，保存其 id，用于后续查询详情、更新或删除。没有记录时，items 为空数组。
列表和详情中的 key 可能是掩码，不能直接用于模型调用；完整密钥请在API Keys页面查看。
选择管理操作
按需要打开对应 Reference，查看参数、响应示例，或使用页面中的在线调试。
| 操作 | 用途 |
|---|---|
| 获取 API Key 列表 | 分页查看 API Key |
| 搜索 API Key | 按名称或密钥值查找 |
| 获取单个 API Key | 根据 ID 读取详细配置 |
| 创建 API Key | 设置名称、额度、有效期和访问限制 |
| 更新 API Key | 修改配置，或单独启用、禁用 |
| 删除 API Key | 删除指定 Key |
| 批量删除 API Key | 一次删除多个 Key |
如需查询某个 Key 自身的剩余额度，使用查询 API Key 额度，鉴权时填写该 Key，而不是访问令牌。
操作注意事项
更新和删除前核对目标
普通更新可能重置省略的字段。请先读取详情，再提交需要保留的完整配置；只需启用或禁用时，使用更新接口的“仅更新状态”方式。
删除会影响依赖该 Key 的应用。请核对目标 ID，不要直接使用示例 ID 执行删除。
- 检查业务结果：HTTP
200也可能表示业务失败，请同时检查响应中的success和message。 - 避免重复写入：创建、更新或删除超时后，先查询确认是否已生效，不要直接重复提交。
- 保护访问令牌：在受控的服务端环境保存，不要写入前端代码、公开日志、截图或代码仓库；含密钥值的搜索 URL 也应避免泄露。