文档中心

访问控制

常见问题

方舟 API Key 与 IAM API Key 有什么关系？

方舟 API Key 通过 IAM 生成，当你在火山方舟控制台创建 API Key 时，方舟会通过服务关联角色（ServiceRoleForArk）为你创建 IAM 用户并分配 IAM API Key，因此你会在 IAM 控制台看到方舟代你创建的 IAM 用户及 API Key。

为在方舟创建的 API Key 添加更多产品权限

当你在方舟控制台创建了 API Key，希望在 IAM 中添加更多产品权限时，可以参考以下操作步骤：

进入访问控制-用户列表页面，在搜索框中粘贴 API Key 搜索出 API Key 归属的 IAM 用户：

在用户右侧的操作列点击添加授权（也可以点击用户进入用户详情页后添加权限）：进入授权页面，查找要授权的服务及权限：

选中权限策略后，点击提交，即可为用户授权，用户的 API Key 将继承用户本身的权限。

说明

IAM 用户通常代表你的一个后端程序或本地客户端，基于 IAM 用户你可以更方便的进行最小化授权、进行密钥轮转和身份访问审计。

直接在访问控制中创建 API Key

同时你也可以在 IAM 控制台中创建 API Key，在添加方舟 AI 推理权限后即可调用方舟模型。在 IAM 中创建 API Key 有如下两种方式：

方式1：创建主账号 API Key。在登录主账号后，你可以直接前往 IAM API 密钥管理页面创建 API Key。主账号 API Key 默认拥有全部权限，建议你开启调用限制，将调用权限限制到具体要访问的产品以降低 API Key 泄露产生的影响。主账号 API Key 仅建议个人开发者在产品探索或测试阶段使用，正式生产环境不建议使用主账号 API Key。企业场景应全面禁止使用主账号 API Key。

方式2：创建 IAM 用户并分配 API Key。你可以在 IAM 用户管理页面中创建 IAM 用户并分配 API Key。IAM 用户通常代表你的一个后端程序或本地客户端，基于 IAM 用户你可以更方便的进行最小化授权、进行密钥轮转和身份访问审计。例如授予方舟 AI 推理权限可以为用户绑定ArkInferenceFullAccess或 ArkFullAccess权限策略。

但不论你是在方舟控制台创建 API Key 还是在 IAM 控制台创建 API Key，你都可以在 IAM 中为对应 API Key 添加其他产品权限，从而实现使用同一个 API Key 调用多个 AI 产品。有关 IAM 凭证的更多说明可参考 API 密钥（API Key 与 Access Key）。

最近更新时间：2026.08.05 16:49:54

这个页面对您有帮助吗？

有用

无用