如何使用 Token
密钥、配额与模型权限说明。
如何使用 Token
“API 密钥”页面中的 Key 是客户端访问模型接口时使用的凭据。请将它与账户登录密码、控制台登录令牌区分开:API Key 用于 API 请求,账户令牌用于控制台会话和管理接口。
Token 类型
| 凭据 | 用途 | 放置位置 |
|---|---|---|
API Key(通常以 sk- 开头) | 调用模型网关 | 客户端密钥栏或服务端环境变量 |
| 账户登录凭据 / JWT | 登录控制台或访问需要用户身份的 API | 仅用于受信任的后端自动化,不能当作模型 API Key |
查看用量
登录控制台打开“使用记录”,按日期、模型或 Key 查看调用与费用;仪表盘可查看汇总。筛选条件会影响显示结果,导出前确认时区和时间范围一致。不要通过把 Key 写进浏览器脚本来读取账户使用记录。
额度和限速
创建或编辑 Key 时,页面可能提供以下配置:
| 设置 | 作用 |
|---|---|
| 总额度 | 限制该 Key 可累计使用的金额;0 或留空的含义以表单提示为准 |
| 5 小时 / 1 天 / 7 天限额 | 控制对应周期的使用上限;具体重置规则查看页面提示 |
| 到期时间 | 到期后停止接受该 Key 的新请求 |
| IP 白名单 / 黑名单 | 按来源地址限制请求 |
| 分组 | 决定可用模型和计费规则 |
仅调整界面实际提供的选项。限额单位、重置方式以创建或编辑表单旁的说明为准。
重置、停用与撤销
编辑 Key 可调整其名称、分组、状态和限制;页面提供重置限额时,确认目标 Key 后再操作。删除或停用会影响后续请求。轮换密钥时先部署新 Key、验证调用,再撤销旧 Key。
使用建议
按项目和环境分开创建 Key;测试与生产使用不同凭据;定期检查“使用记录”;怀疑泄露时立即停用或删除,并重新签发。