阿里云百炼 API Key 获取教程：控制台一键创建、sk- 密钥仅显示一次如何保存（附 Dify/Chatbox 配置），阿里云百炼怎么获取API Key？百炼是阿里云AI大模型平台，阿小云整理详细的API Key获取流程，超简单，根据提示一步步操作即可，开通百炼阿里云会自动为你的阿里云账户发放超7000万Tokens，每个模型100万Token，阿里云百炼官网：https://www.aliyun.com/product/bailian 本文阿小云详解百炼API Key获取方法及相关问题解答：
百炼API Key获取流程
1、登录阿里云百炼控制台，点击右上角的【大模型服务平台百炼控制台】如下图：
2、在常用功能模块，找到【API Key】如下图：
3、点击右上角【创建API Key】如下图：
如上图，点击【创建API Key】选择归属业务空间和权限，描述随便填自己知道就行，如下图：
- 归属账号：选择阿里云账号（主账号）即可，账号名通常为一串数字。如需为团队成员或应用创建权责独立的 API Key，并结合归属业务空间进行精细化的模型访问控制，那么归属账号应选择：RAM 用户
- 归属业务空间：选择“默认业务空间”，此空间下的 Key 可调用所有标准模型。
- 权限：建议选择全部，若有更精细的权限控制需求，可以选择自定义来控制可访问 IP 和 可访问模型。
然后点击【确定】即可获取到到你的API Key，创建后仅显示一次，请立即复制或下载。妥善保管 —— 任何人持有该 Key 都可以您的身份发起请求并产生费用。
下面开始第二步骤，配置API Key。
配置 API Key
关于百炼API Key配置有两种方法，可以在第三方工具中进行配置，也可以配置 API Key 到环境变量，后续支持 cURL 和代码调用。
方式一：在第三方工具中进行配置
如果在 Chatbox 等工具或平台中调用模型，您可能需要输入三个信息：
1、本文获取的 API Key
2、Base URL：
中国大陆版：https://dashscope.aliyuncs.com/compatible-mode/v1 国际版：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
3、模型名称，如 qwen-plus、qwen3-8b、deepseek-r1 等。
阿里云提供了一些第三方工具配置百炼API Key的方法，参考：Dify、Chatbox、Cline、Claude Code、Postman。
方式二：配置 API Key 到环境变量，后续支持 cURL 和代码调用
以下代码中请将 部分替换为真实的 API Key。
Linux系统添加永久性环境变量
将环境变量设置追加到~/.bashrc文件中：
echo "export DASHSCOPE_API_KEY='<YOUR_API_KEY>'" >> ~/.bashrc source ~/.bashrc echo "百炼 API Key 永久配置为：${DASHSCOPE_API_KEY:0:10}*********"
添加临时性环境变量：
export DASHSCOPE_API_KEY='<YOUR_API_KEY>' echo "当前会话百炼 API Key 配置为：${DASHSCOPE_API_KEY:0:10}*********"
更多请参考阿里云官方文档：https://help.aliyun.com/zh/model-studio/get-api-key
API Key常见问题解答
1、无法创建 API Key？
API Key 的创建需使用超级管理员或业务空间管理员操作。
2、如何管理 API Key 的权限？
API Key 的调用权限完全由其归属业务空间决定。同一空间内的 API Key 权限相同，无需为不同模型（如文生文、文生图、语音合成）创建不同的 API Key。
调用在阿里云百炼调优后的模型：此类模型部署成功后，仅能用其所在业务空间的API Key调用。
如需在业务空间之外做更细粒度的控制，可在创建或编辑 API Key 时将权限切换为自定义，配置：
- IP 访问白名单：仅允许名单内的 IP 使用该 API Key 发起调用。支持 IPv4 与网段，默认 IPv4（
0.0.0.0/0）全部放通；IPv6 仅华北2（北京）地域支持，美国（弗吉尼亚）地域仅支持 IPv4。最多支持 20 个地址或网段，批量输入请用英文逗号隔开。 - 访问模型范围：开关开启后，该 API Key 仅能调用已勾选的模型，可选模型限于该业务空间已授权的模型。
3、环境变量已设置，为何代码仍提示找不到 API Key？
具体原因如下：
- 情况一：没有设置永久性环境变量。临时环境变量只在当前终端会话中有效，对于已经启动的 IDE 或其他应用程序并不会生效。请参考本文中设置永久性环境变量的方法。
- 情况二：没有重启IDE、命令行工具或应用。
- 通常需要重启 IDE（如 VS Code）或命令行工具，使其能够加载最新的环境变量。
- 如果在部署应用后设置了环境变量，可能需要重启应用服务，让应用能够重新加载环境变量。
- 情况三：需要在配置文件添加环境变量。如果您的应用是通过服务管理器（如 systemd、supervisord）启动的，可能需要在服务管理器的配置文件中添加环境变量。
- 情况四：用了sudo命令。如果使用
sudo python xx.py运行脚本，可能会遗漏当前用户环境变量，因为sudo默认不继承所有环境变量。您可采用sudo -E python xx.py命令，其中的-E参数确保环境变量被传递。如有权限执行该脚本，可以直接执行python xx.py。
4、单个主账号下最多能创建多少个API Key？
每个主账号下最多可创建20个业务空间（包括默认业务空间），每个业务空间下最多可创建20个API Key。
更多关于阿里云百炼API Key的介绍，请移步到阿里云百炼官网查看：https://www.aliyun.com/product/bailian
