如何创建和管理 API 密钥？

API 密钥是程序调用 Favonis API 时出示的凭据，以 fvk_ 开头。密钥属于创建它的人，按创建时所在的空间使用：在个人空间创建的密钥代表你的个人账号，扣个人空间的积分；在团队空间创建的代表你在该团队中的成员身份，扣团队积分，也只能访问你在这个团队里的任务和文件。

API 密钥和个人密钥不是一回事：个人密钥是你在模型服务商申请、交给 Favonis 调用模型用的。

创建密钥

创建密钥前需要先完成实名认证。

1. 切换到要使用的空间，打开设置 → 开发者，在 API 密钥 页签中点击右上角的新建密钥。
2. 填写名称，方便以后区分是哪个程序在用。
3. 按需要选择权限（完全访问或只读）和有效期。选择完全访问时，另有选填的每月积分上限，见下面的说明。
4. 点击创建。弹出确认是你本人时，按窗口中列出的方式确认身份。
5. 复制密钥，保存到安全的地方。密钥只显示这一次，关闭后无法再查看。

你在每个空间中最多可以有 20 个密钥，团队里其他成员的密钥不计在内。

权限、上限和有效期

只读密钥只能查看任务、项目和文件，不能新建任务、发消息或上传文件，也不会消耗积分。只想让程序读取结果时，用只读密钥更安全。

每月积分上限按北京时间的自然月，统计这个密钥发起的任务消耗的积分。达到上限后，程序不能再用这个密钥新建任务或发消息，包括补充说明、回答提问和让暂停的任务继续；已在运行的任务照常完成，所以当月的消耗可能略高于上限。下个月 1 日起恢复。

有效期有永不过期、30 天、90 天和1 年四种，默认永不过期。到期后密钥失效，需要另外新建一个。

管理密钥

密钥列表显示每个密钥的名称、开头几位、最近使用时间、本月已用积分和到期日期。只读、已过期或本月已达上限的密钥，名称旁分别显示只读、已过期、已达上限。

密钥右侧有重命名、修改每月积分上限和删除三个按钮，只读密钥不显示修改每月积分上限。权限和有效期创建后不能修改，需要时新建一个密钥，再删除旧的。

删除后，使用这个密钥的请求立即被拒绝。怀疑密钥泄露时，请立即删除它。离开团队时，你在这个团队中创建的密钥会一并删除。

保管密钥

密钥等同于你账号的凭据，通过它发起的操作都算作你本人的操作，积分照常扣除。请把密钥放在服务器的环境变量或密钥管理工具中，不要写进网页、发给别人或提交到公开的代码仓库。不同的程序使用不同的密钥，出问题时只需删除其中一个。