获取API Key

一、开通阿里云百炼的模型服务

使用阿里云主账号访问阿里云百炼大模型服务平台，如果页面顶部显示开通提示，您需开通阿里云百炼模型服务，以获得新人免费额度。开通阿里云百炼不会产生费用，仅模型调用（超出免费额度后）、模型部署、模型调优会产生相应计费。如果页面顶部未显示开通提示，则表示您已经开通。

如果开通服务时提示“您尚未进行实名认证”，请先进行实名认证。

二、获取API Key

开通阿里云百炼后，您需要手动创建API Key，系统不会自动生成。

1. 前往密钥管理页面，在API-Key页签（下图位置①）下单击创建API-KEY（下图位置②）。

   

2. 在创建API-KEY弹窗中，选择API Key的归属账号及归属业务空间，填写描述信息，并单击确定。

   • 归属账号：可选择主账号或子账号（当人员离职或岗位变动时，只需将其子账号移出业务空间，对应API Key将自动失效，不再具备调用权限）。

   • 归属业务空间：通常选择默认业务空间（即主账号空间）。若需管控某类用户可调用的模型，或对模型调用的费用进行分账，请创建/选择列表中的子业务空间。详见子业务空间的模型调用。

     说明

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

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

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

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

3. 点击API Key旁的图标（上图位置③）获取该API Key。

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

三、使用API Key

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

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

  • 本文获取的API Key

  • Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1

  • 模型名称，如qwen-plus

  我们也提供了一些常用工具的配置方法：Dify、Chatbox、Cline、Claude Code、Postman。

• 方式二：通过代码调用模型

  如果通过代码调用模型，建议配置API Key到环境变量，避免将API Key明文写在代码中，从而降低泄漏风险。

API Key时效性说明

通过API-Key页面创建的API Key永久有效，手动删除后即失效。

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