阿里云百炼API-Key获取方法:创建、配置及问题解答FAQ

阿里云百炼怎么获取API Key?百炼是阿里云AI大模型平台,阿小云整理详细的API Key获取流程,超简单,根据提示一步步操作即可,开通百炼阿里云会自动为你的阿里云账户发放超7000万Tokens,每个模型100万Token,阿里云百炼官网:aliyunbaike.com/go/bailian 本文阿里云百科详解百炼API Key获取方法及相关问题解答:

阿里云百炼AI模型官网

百炼API Key获取流程

1、登录阿里云百炼控制台,点击右上角的【大模型服务平台百炼控制台】如下图:

阿里云百炼管理控制台

2、在常用功能模块,找到【API Key】如下图:

阿里云百炼API Key创建获取方法

3、点击右上角【创建API Key】如下图:

阿里云百炼创建API Key

如上图,点击【创建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://t.aliyun.com/U/falQbU

API Key常见问题解答

1、无法创建 API Key?

API Key 的创建需使用超级管理员或业务空间管理员操作。

2、如何管理 API Key 的权限?

API Key 的调用权限完全由其归属业务空间决定。同一空间内的 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的介绍,请移步到阿里云百炼官网查看:aliyunbaike.com/go/bailian

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容