火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟准备工作获取 API Key 并配置
复制全文
下载 pdf获取 API Key 并配置
文档反馈
问问助手您调用方舟平台的模型之前，您需要 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 继续有效，无需重新生成。
获取 API Key
- 登录控制台。
- （可选）在控制台左下角切换项目空间，然后选择 API Key 管理。
- 单击 创建 API Key 按钮。
- 在弹出框的 名称 文本框中确认/更改 API Key名称，单击创建。
- 您可以在 API Key 管理 页面的 API Key 列表中查看刚创建的API Key信息。
-
配置 API Key
推荐将 API Key 配置在环境变量中，而不是硬编码进代码中，避免 API Key 随代码泄露，导致配额被他人使用，产生额外花费。
使用说明
- API Key 配额：一个主账号下支持创建 50 个API Key，如需更多配额请提交 工单 申请。
- API Key 权限控制：API Key 创建于您当前所在项目，用于访问当前项目下的资源（即模型服务和应用）。您可为 API Key 额外限制可鉴权的 Model ID /自定义推理接入点，或可调用该 API Key 的 IP。
- TIPS ：您切换项目空间创建 API Key，可限制 API Key 只用于指定项目空间下的模型服务的鉴权凭证。当您的账号是多人使用，可以通过此方法进行权限隔离。
- 注意：API Key 仅支持访问指定项目下的接入点，不支持跨项目访问。当您跨项目迁移了接入点，则原 API Key 鉴权将失效。
最近更新时间：2026.09.19 00:09:35
这个页面对您有帮助吗？
有用
有用
无用
无用