# 获取 API Key 并配置

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

您调用方舟平台的模型之前，您需要 API Key 来进行鉴权。同时因为 API Key 信息较为敏感，泄露 API Key 会导致您的模型用量被其他人花费，造成一定的损失，因此我们会给出配置 API Key 进环境变量的方法，方便您合理安全地使用API Key。

> **注意：API Key 明文格式变更**
>
> 2026 年 9 月 17 日 12:00（UTC+8）之后创建的 ModelArk API Key 将使用新的明文格式。本次调整仅涉及 API Key 格式，不影响 API 鉴权方式。该时间点以前创建的 API Key 继续有效，无需重新生成。

<span id="20bdcc68"></span>
## 获取 API Key

1. 登录控制台。
2. （可选）在控制台左下角切换项目空间，然后选择 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey)。
3. 单击 **创建 API Key** 按钮。
4. 在弹出框的 **名称** 文本框中确认/更改 API Key名称，单击创建。
    您可以在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面的 **API Key 列表**中查看刚创建的API Key信息。
<span id="f1908ee9"></span>
## 配置 API Key

推荐将 API Key 配置在环境变量中，而不是硬编码进代码中，避免 API Key 随代码泄露，导致配额被他人使用，产生额外花费。
配置方法见：[环境变量配置指南](/docs/environment-variable-configuration-guide)。

<span id="64cf3cd0"></span>
## 使用说明

* API Key 配额：一个主账号下支持创建 50 个API Key，如需更多配额请提交 [工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00001166) 申请。

* API Key 权限控制：API Key 创建于您当前所在项目，用于访问当前项目下的资源（即模型服务和应用）。您可为 API Key 额外限制可鉴权的 Model ID /自定义推理接入点，或可调用该 API Key 的 IP。

    * TIPS ：您切换项目空间创建 API Key，可限制 API Key 只用于指定项目空间下的模型服务的鉴权凭证。当您的账号是多人使用，可以通过此方法进行权限隔离。

    * 注意：API Key 仅支持访问指定项目下的接入点，不支持跨项目访问。当您跨项目迁移了接入点，则原 API Key 鉴权将失效。