阿里云百炼怎么获取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 和代码调用
以下代码中请将<YOUR_API_KEY> 部分替换为真实的 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