账户与 API 密钥
API 密钥用来让客户端或程序调用模型。控制台登录密码和 API 密钥是两回事,不能互相替代。
创建密钥
在「API 密钥」点「创建 API 密钥」,按表单填写:
| 字段 | 说明 |
|---|---|
| 名称 | 方便自己辨认,例如「笔记本 Codex」。建议每台设备、每个项目各建一把,方便看用量和停用 |
| 分组 | 必填,最重要的一项。决定这把密钥能用哪些模型、怎么计费。本站没有默认分组,不选无法保存,选法见分组说明 |
| 过期时间 | 默认永不过期,也可以选 1 小时、1 天、1 个月或自定义 |
| 数量 | 一次创建多把,名称会自动加随机后缀 |
| 额度设置 | 默认「无限配额」,即只受账户余额限制。关掉后可以给这把密钥单独设上限 |
| 模型限制 | 只允许这把密钥调用指定的模型 |
| IP 白名单 | 每行一个 IP,支持 CIDR。留空表示不限制 |
| 允许查询用户额度 | 开启后,可以用这把密钥查询账户的剩余额度和已用额度,见使用日志与账单 |
密钥额度不是账户余额。账户余额不足、密钥额度用完、密钥过期、请求 IP 不在白名单里,都会让调用被拒绝。
密钥列表里的操作
| 操作 | 用途 |
|---|---|
| 复制密钥 | 复制完整密钥(sk- 开头) |
| 复制连接信息 | 复制一段包含密钥和 API 地址的 JSON |
| CC Switch | 一键导入到 CC Switch,见 CC Switch 一键导入 |
| 聊天 | 一键打开 Cherry Studio、DeepChat 等客户端并填好配置 |
| 编辑 | 修改名称、分组、额度、过期时间和访问限制 |
| 禁用 / 启用 | 临时停用,不删除 |
| 删除 | 永久删除,用到它的客户端需要换新密钥 |
列表上方的「API 地址」按钮可以复制本站的调用地址 https://api.peroai.cc。
改分组要注意
一把密钥只属于一个分组。改分组后,原来能用的模型可能不能用了,价格也会变。改完请到模型广场重新核对模型 ID。
密钥泄露怎么办
- 立即在控制台禁用或删除这把密钥。
- 创建新密钥,更新所有用到它的客户端和服务。
- 到「使用日志」按旧密钥名称筛选,检查有没有异常调用。
不要把完整密钥发到群聊、截图、公开仓库或网页前端代码里。联系我们排查问题时也不需要提供完整密钥。
账户安全
在控制台「安全与访问」可以:
- 修改密码;
- 开启两步验证(身份验证器 App),并保存好备用码;
- 注册 Passkey(通行密钥),之后可以免密码登录;
- 查看登录会话,退出其他设备;
- 管理「访问令牌」。访问令牌用于在脚本里调用控制台接口,不能用来调用模型,调用模型要用 API 密钥。
目前站点没有开启邮件服务,「忘记密码」无法发送重置邮件。忘记密码请按安全与支持联系我们。