用户指南
令牌管理
令牌是调用 API 的凭证，每个令牌可独立配置权限范围和配额上限
令牌是调用 API 的凭证，每个令牌可独立配置权限范围和配额上限。登录后在左侧「控制台区域 → 令牌管理」进入，或直接访问 `/console/token`。
访问令牌管理
- 登录 EasyAPI 控制台
- 在左侧「控制台区域」点击「令牌管理」，或访问
/console/token
令牌列表
列表展示所有已创建令牌，包含名称、状态、剩余/总额度、分组、脱敏密钥、可用模型、IP 限制与时间信息。
- 顶部可「添加令牌」「刷新所有令牌」，以及删除所选 / 删除所有
- 右侧可按名称关键词或密钥片段搜索，支持分页与每页条数切换
- 「紧凑列表」可隐藏模型与 IP 列，适合窄屏浏览
- 行内开关可快速启用或禁用令牌；「聊天」菜单可跳转操练场或一键导入第三方客户端
| 名称 | 状态 | 剩余/总额度 | 分组 | 密钥 | 操作 | |
|---|---|---|---|---|---|---|
| ☐ | production | 已启用 | ∞ / ∞ | default | sk-•••••••• | 聊天 · 编辑 · 删除 |
| ☐ | dev-test | 已禁用 | 120 / 500 | test | sk-•••••••• | 聊天 · 编辑 · 删除 |
令牌列表示意：工具栏 + 表格行操作
创建令牌
基本配置
- 在令牌列表页点击「添加令牌」，右侧滑出创建面板
- 填写令牌名称（建议按用途命名，如「生产环境」「本地测试」）
高级配置选项
按需配置以下选项：
| 配置项 | 说明 |
|---|---|
| 过期时间 | 创建时可选 7 / 30 / 90 天或永不过期；编辑时可精确设置日期时间 |
| 配额模式 | 共享账户额度，或为该令牌设置独立额度上限 |
| 无限配额 | 独立额度模式下可开启，不受该令牌额度上限约束（仍受账户总配额影响） |
| 模型限制 | 开启后可勾选允许调用的模型，未开启表示不限制 |
| IP 白名单 | 每行填写一个 IP，留空表示不限制来源 |
| 分组 | 指定令牌使用的渠道分组（如 default、prod、test 等） |
| 跨分组重试 | 当前分组无可用渠道时，是否尝试其他分组 |
保存令牌 Key
- 点击「提交」创建令牌
- 弹窗展示完整令牌 Key，立即点击「复制」保存
- 关闭弹窗后，列表中仅显示脱敏密钥；再次查看完整 Key 需调用密钥接口
令牌 Key 具有完整 API 调用权限，请勿泄露或提交到公开代码仓库。创建时若未及时复制，请妥善保管后续获取的完整密钥。
编辑令牌
在列表中点击令牌名称或右侧「编辑」，可修改过期时间、配额、模型限制、IP 白名单、分组与跨分组重试等配置。
- 可切换令牌启用 / 禁用状态（已过期令牌不可启用）
- 独立额度模式下可调整剩余额度与总额度
- 密钥本身不在编辑表单中展示；如需更换请使用重置密钥流程
删除令牌
在列表中点击「删除」，或使用「删除所选」「删除所有令牌」批量操作，确认后令牌立即失效且无法恢复。