在使用阿里云百炼的大模型或应用之前,必须先取得API Key——这是调用服务时用于身份验证的凭证,没有它,接口将无法响应。以下将完整拆解从创建、配置到保存的每一步操作,每个环节都对应实际节点,按顺序执行即可。如果您选用的是Token Plan或Coding Plan,则需要走另一条路径,对应的API Key前缀为sk-sp-,获取方式与本文介绍的按量付费密钥不同,具体请参考文末的官方帮助文档。
阿里云百炼API Key获取方法
首先访问阿里云百炼平台官网:https://www.aliyun.com/product/bailian,在页面右上角选择地域——当前支持华北2(北京)、新加坡、日本(东京)、德国(法兰克福)。接着在百炼平台中找到“创建API Key”的入口并点击进入,如下图所示:

在弹出的配置窗口中,需要填写以下信息,完成后单击“确定”:
- 归属业务空间:建议直接选择默认业务空间,操作更简便。
- 描述(可选,最多200字符):可随意添加备注,例如“用于生产环境”或“测试用”,方便日后快速识别该Key的用途。
- 权限:推荐选择“全部”,最为省心;若需精细控制(如限制仅能访问某些模型或IP地址),则选择“自定义”进行配置。
界面效果如下:

关于权限配置,这里再补充一些说明。阿里云百炼提供了两种权限策略:
- 全部:获取Key后即可畅通无阻地调用所有模型和应用。
- 自定义:可设置IP白名单(最多支持20个IPv4或IPv6地址/网段),并限定可调用的模型范围。默认情况下IPv4为
0.0.0.0/0全放通,IPv6仅在北京地域支持。

创建成功后,弹窗会直接展示完整的API Key和API Host(服务端点地址)。此窗口仅显示一次,关闭后无法再查看明文——因此务必立即复制或下载保存。请牢记:获得该Key的人即可代表您的身份发起请求并产生费用,保管不当会带来直接后果。如果确实丢失了,只能重置或重新创建一个新的Key。
主账号可以查看所有业务空间下的API Key,而子账号只能查看自己已加入的业务空间中的Key。
API Key创建完成后,复制下来即可直接用于调用。以上流程针对按量付费的API调用模式。如果您使用的是Token Plan或Coding Plan,则需走另一套流程:Token Plan API Key获取方法详见https://help.aliyun.com/zh/model-studio/coding-plan,Coding Plan API Key获取方法详见https://help.aliyun.com/zh/model-studio/coding-plan。简单来说,专属Key以sk-sp-开头,请勿与按量付费的Key混淆。
