​

API 密钥

当你需要凭据以从自己的应用或服务调用 Fetch Hive 部署时,使用 API Keys。本页面管理工作区 API 密钥,而非用于个人模型使用的第三方提供商密钥。

​

概述

页面将 Default API Key 与你为特定环境或服务创建的其他密钥区分开来。其他密钥显示在表格中,你可以在其中搜索、筛选、轮换、撤销并查看最近使用情况。 Fetch Hive 支持按环境区分的密钥,因此你可以将 Production、Staging 和 Development 的访问权限分开管理。

​

如何创建 API 密钥?

在侧边栏打开 Settings,然后点击 API Keys。 如果工作区还没有默认密钥,点击 Create Default Key。 如果你想创建其他密钥,点击 Add API Key。 输入名称并选择环境。所有者和管理员还可以勾选允许此密钥自动批准操作。这样，使用该密钥的请求可以发送 tool_approval: "auto_approve"。成员可以看到该复选框，但不能更改它。破坏性操作和拒绝规则仍然适用。参见代理操作的批准。 选择环境:

• Production
• Staging
• Development

保存密钥。Fetch Hive 随后会显示 Your New API Key。 请立即复制完整密钥。完整值仅在密钥首次创建或轮换时显示一次。

​

如何轮换或撤销密钥?

在 Default API Key 或其他密钥表格中找到你想要更改的密钥。 当你想用新密钥替换当前密钥时,使用 Rotate Key。 当你想禁用某个密钥并阻止其将来被使用时,使用 Revoke。 Fetch Hive 在执行任一操作前都会要求你确认。

​

为什么我只能复制密钥的一部分?

创建或轮换对话框关闭后,页面会保留已遮蔽的密钥前缀以便参考,但通常无法再复制完整密钥值。 这就是为什么你应在关闭该对话框之前从 Your New API Key 中复制完整密钥。 遮蔽显示仍然有用,可以用来确认你查看的是哪个密钥,以及检查其环境、状态和最近使用信息。

​

如何限制密钥的支出?

你可以为任何 API 密钥设置每月支出上限。在密钥上打开 Edit,然后使用 每月支出上限。

• 提醒金额(美元):当该密钥本月支出超过此金额时,Fetch Hive 会向账户所有者发送一封邮件(仅一次)。
• 阻止金额(美元):当该密钥本月支出达到此金额时,使用该密钥的新请求会被拒绝并返回 spend_cap_exceeded 错误。工作区中的其他密钥不受影响。

上限统计的是自然月(UTC)内的托管 AI 支出,并在每月第一天重置。上限达到时已在运行的请求会完成并计费;下一个请求会被阻止。 你也可以在 Workspace Settings 中为整个工作区设置上限。API 密钥页面的 每月上限 列会显示每个密钥的已用支出与上限。只有账户所有者和管理员可以更改上限。 spend_cap_exceeded 的响应请参阅错误代码。

​

这与提供商凭据有什么不同?

工作区 API 密钥用于对 Fetch Hive 部署的请求进行身份验证。 它们不同于你为 Personal 计费类型所连接的提供商凭据。对于该流程,请参阅使用你自己的 API 密钥和集成。