文档 / 开始使用

账户与 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。

密钥泄露怎么办

  1. 立即在控制台禁用或删除这把密钥。
  2. 创建新密钥,更新所有用到它的客户端和服务。
  3. 到「使用日志」按旧密钥名称筛选,检查有没有异常调用。

不要把完整密钥发到群聊、截图、公开仓库或网页前端代码里。联系我们排查问题时也不需要提供完整密钥。

账户安全

在控制台「安全与访问」可以:

  • 修改密码;
  • 开启两步验证(身份验证器 App),并保存好备用码;
  • 注册 Passkey(通行密钥),之后可以免密码登录;
  • 查看登录会话,退出其他设备;
  • 管理「访问令牌」。访问令牌用于在脚本里调用控制台接口,不能用来调用模型,调用模型要用 API 密钥。

目前站点没有开启邮件服务,「忘记密码」无法发送重置邮件。忘记密码请按安全与支持联系我们。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。