AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页 大模型服务平台百炼 API参考（模型） 准备工作 获取API Key

获取API Key

更新时间：
复制为 MD 格式
产品详情
我的收藏

使用阿里云百炼的大模型或应用前，请先获取API Key作为鉴权凭证。

一、获取API Key

重要

需使用主账号，或具备管理员或API-Key页面权限的子账号操作。

华北2（北京）地域

  1. 前往阿里云百炼控制台首页，在页面右上角选择华北2（北京）地域，进入API Key页面，单击创建API KEY。

  2. 在弹窗中配置以下信息，并单击确定：

    • 归属业务空间：建议选择默认业务空间。

    • 权限：建议选择全部，若有更精细的权限控制需求，可以选择自定义。

    如何选择 API Key 的权限配置？

    阿里云百炼提供两种类型的权限配置，请根据实际需求进行选择：

    • 全部：授予该 API Key 调用所有模型与应用的权限。

    • 自定义：按需勾选特定模型或应用，实现最小权限原则。您可以配置：

      • IP 访问白名单：仅允许名单内的 IP 使用该 API Key 发起调用（支持 IPv4、IPv6 与网段）。

      • 访问权限范围：为该API Key 勾选可访问的模型或应用；未勾选的资源无法通过此API Key 调用。

  3. 点击API Key旁的image图标获取该API Key。

    主账号可以查看全部API Key，子账号仅能查看自己创建的API Key。

    image

新加坡等其他地域

  1. 前往阿里云百炼控制台首页，在页面右上角选择目标地域，进入API Key页面，单击创建API KEY。

  2. 在弹窗中配置以下信息，并单击确定：

    • 归属账号：建议选择主账号（账号列内容为纯数字账号ID）。

    • 归属业务空间：建议选择默认业务空间。

  3. 点击API Key旁的image图标获取该API Key。

    主账号可以查看全部API Key，子账号仅能查看自己创建的API Key。

    2026-02-11_11-56-27

何时选择其他归属账号或业务空间？

如果您有团队协作或成本分摊需求，可以了解以下概念：

  • 归属账号：可选择主账号和子账号。如果希望 API Key 与特定成员绑定，方便在人员变动时管理权限，则应选择对应的子账号。当该子账号被移出业务空间，对应API Key将自动失效，不再具备调用权限。

  • 归属业务空间：用于隔离不同项目或团队的资源和权限。若需管控某类用户可调用的模型，或对模型调用的费用进行分账，请创建/选择列表中的子业务空间。

详情请参见权限管理以及账单查询与成本管理。

二、使用API Key

说明

Coding Plan应使用专属 API Key（格式：sk-sp-xxxxx），而非本文介绍的百炼通用 API Key（格式：sk-xxxxx）。获取 Coding Plan 专属 API Key 请参见获取套餐专属 API Key 和 Base URL。

  • 方式一：在第三方工具中调用模型

    如果在Chatbox等工具或平台中调用模型，您可能需要输入三个信息：

    • 本文获取的API Key

    • API Key所属地域的Base URL：

      • 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1

      • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1

      • 美国（弗吉尼亚）：https://dashscope-us.ali/yuncs.com/compatible-mode/v1

    • 模型名称，如qwen-plus

常用工具配置：Chatbox、Cline、Claude Code、Dify、OpenClaw（原 Clawdbot/Moltbot）、Postman、Qwen Code。

请勿以任何方式公开API Key，避免因未经授权的使用导致安全风险或资金损失。

API Key权限说明

API Key的调用权限完全由其归属业务空间决定。同一空间内的API Key权限相同，无需为不同模型（如文生文、文生图、语音合成）创建不同的API Key。

  • 默认业务空间下的API Key：可调用所有标准模型，以及默认业务空间内的应用。

  • 子业务空间下的API Key：可调用该子业务空间已获得授权的标准模型，以及该子业务空间内的应用。

调用在阿里云百炼调优后的模型：此类模型部署成功后，仅能用其所在业务空间的API Key调用，无需授权。

说明

目前仅华北2（北京）地域支持为 API Key 配置更精细的权限控制。

您可以在创建 API Key 或点击已有 API Key 操作列的编辑时，将权限切换为自定义，即可按需配置：

  • IP 访问白名单：仅允许名单内的 IP 使用该 API Key 发起调用（支持 IPv4、IPv6 与网段）。

  • 访问权限范围：为该API Key 勾选可访问的模型或应用；未勾选的资源无法通过此API Key 调用。

API Key时效性说明

创建的API Key永久有效，手动删除后即失效。

若需为第三方应用或用户提供临时访问权限，或需严格控制敏感数据访问、删除等高风险操作，可生成临时 API Key（有效期60秒），避免暴露长期有效的API Key，降低泄露风险。

常见问题

Q：单个主账号下最多能创建多少个API Key？

A：每个主账号下最多可创建20个业务空间（包括默认业务空间），每个业务空间下最多可创建20个API Key。

Q：RAM用户被删除后，其创建的API Key是否依然可用？

A：在RAM控制台中禁用或删除RAM用户后，其创建的所有API Key均将失效，无法再用于模型调用。

上一篇：准备工作下一篇：配置API Key到环境变量