控制台
令牌管理
在控制台创建、查看、编辑和删除 API 密钥（令牌），设置额度、过期时间、模型范围和分组。
令牌（API Key）在控制台左侧菜单「API 密钥」页管理：https://ai.athandra.com/keys。页面以表格展示每个密钥的名称、状态、掩码密钥、额度、分组、可用模型、IP 限制、创建时间、最后使用时间和过期时间，并支持按名称或密钥筛选。
创建 API 密钥
- 打开「API 密钥」，点击「创建 API 密钥」，右侧会滑出创建面板。
- 填写「名称」，选择「分组」，按需设置过期时间。
- 在「额度设置」里设置额度（USD），或打开「无限配额」。
- 需要限制范围时，展开「高级设置」选择允许的模型、填写 IP 白名单。
- 点击「保存更改」。
配置项说明
| 选项 | 作用 | 建议 |
|---|---|---|
| 名称 | 仅用于你自己区分 | 按项目命名，如 blog-bot |
| 分组 | 决定令牌能用哪些模型、价格倍率是多少 | 见下文「分组」 |
| 过期时间 | 到期后令牌自动失效，默认永不过期；可选「永不」「1 个月」「1 天」「1 小时」或自定义 | 临时给外部协作者的令牌务必设过期时间 |
| 数量 | 一次创建多个密钥，名称会添加随机后缀 | 批量分发给多人时使用 |
| 额度（USD） | 该令牌最多能花多少；打开「无限配额」则只受账户余额限制 | 给自动化脚本、第三方工具单独设一个小额度 |
| 模型限制 | 高级设置里选择允许的模型，留空表示允许所有 | 想防止误用贵价模型时设置 |
| IP 白名单 | 高级设置里填写，支持 CIDR 表达式 | 服务端固定出口 IP 时建议开启 |
API 密钥等同于密码。不要把完整密钥提交到代码仓库、截图、日志或聊天工具；怀疑泄露时应立即删除并创建新密钥。
分组
分组在创建令牌时选择，不同分组提供的模型不同。目前线上有：
default：DeepSeek、通义千问、GLM、Kimi、MiniMax 等official：在default的基础上，提供原生 Claude 等模型（例如claude-haiku-4-5只有official分组的令牌能用）pool：独立的分组，可用模型以/v1/models为准
你的账号可用哪些分组、各自价格倍率，以「创建 API 密钥 → 分组」下拉框和 价格页 为准。
如果调用时出现 分组 xxx 下模型 yyy 无可用渠道，通常就是令牌分组不对，换一个分组的令牌即可，见 错误排查。
查看和复制密钥
列表里的密钥默认是掩码显示（例如 sk-N63h**********q6hT）。点击掩码密钥可以查看并复制完整值。
编辑、禁用和删除
在列表的「操作」列：
- 「编辑」：修改名称、额度、过期时间等配置（密钥本身不会变）。
- 「禁用」：保留配置，立即停止调用；之后可以重新启用。
- 「打开菜单」：更多操作，包括删除。删除后该密钥立即失效，无法恢复。
选择多行后可以批量删除。
查看令牌和剩余额度
控制台的令牌列表直接显示已用、总额度和使用比例（以美元显示）。也可以用接口查询当前令牌：
#!/usr/bin/env bash
# 查询当前令牌的额度（单位为“额度”，500000 额度 = 1 美元）
curl -sS https://ai.athandra.com/api/usage/token/ \
-H "Authorization: Bearer $ATHANDRA_API_KEY"
{
"code": true,
"data": {
"name": "my-first-key",
"total_granted": 2500000,
"total_used": 1825,
"total_available": 2498175,
"unlimited_quota": false,
"expires_at": 0,
"model_limits_enabled": false
},
"message": "ok"
}字段单位是「额度」，total_available / 500000 即剩余美元数；expires_at 为 0 表示永不过期。
安全建议
- 一个项目一个令牌，泄露后只需删除那一个。
- 不要把 Key 写进前端代码或提交到仓库；放服务端环境变量。
- 发现异常消耗，先在控制台禁用或删除该令牌，再到 使用日志 排查来源。