文档中心

火山方舟

权限管理

管理 API Key

当您通过代码调用大模型或应用时，需要获取 API Key 作为鉴权凭证。方舟控制台上的 API Key 管理页面可帮助您创建和管理API Key。

功能入口

创建 API Key

创建 API Key，作为调用大模型或应用的鉴权凭证。

火山方舟的 API Key 提供以下能力：

功能	说明
按资源项目（Project）隔离调用权限	您可在控制台左上角切换资源项目，在不同项目中创建的 API Key 仅可用于该项目中资源使用的鉴权凭证。
精细化权限控制	全部：可访问一个资源项目下全部资源。自定义：可自定义指定部分资源的访问权限，灵活控制 API Key 对资源项目内特定资源的使用权限。当前支持从 Model ID、自定义推理接入点维度进行细粒度的权限设置。
IP 调用白名单	限制可调用模型的 IP 地址。注：启用 IP 白名单后，仅添加至白名单的 IP 地址可调用模型。

查询/获取 API Key

支持在 API Key 管理页面查询已有的 API Key，查看当前 API Key 的状态、权限、最后使用时间、创建人等信息。

注意

请勿以任何方式公开 API Key，避免被他人使用造成安全风险或资金损失。

编辑权限

支持随时调整 API Key 可访问的权限范围，包括 IP 调用白名单、可访问的具体资源等，以满足不同场景下对 API Key 使用权限的灵活配置需求，确保系统安全与业务需求的平衡。

说明

API Key 权限控制与模型调用（Model ID、自定义推理接入点）相关的数据面 API 权限。如需设置管控面权限，需使用访问控制 (IAM)，具体信息请参考使用 IAM 管理权限。

禁用/启用 API Key

删除 API Key

当您出于安全角度更新或者不再使用API Key进行鉴权时，您可以删除您的API Key。

申请配额

一个主账号下支持创建 50 个API Key。

如需更多配额，可在项目配置 > 配额管理 > 其他申请配额。

注：此操作需要配额中心的操作权限。

安全设置

控制一个资源项目成员只能管理自己创建的 API Key，从而增强 API Key 管理的安全性和规范性。

默认情况下，项目成员（子账号）可查看并管理当前项目下的所有 API Key；如对权限有更严格管控要求，项目管理员（主账号）可开启限制成员权限。开启后，项目成员仅可查看、编辑、禁用/启用、删除自己创建的 API Key，无权操作他人创建的 API Key。

您需要在顶部菜单栏选择资源项目后，才能看到安全设置信息。

最近更新时间：2025.12.16 23:58:32

这个页面对您有帮助吗？

有用

无用