当您需要通过API或SDK方式调用大模型及应用时,请先参考本文获取API Key作为调用时的鉴权凭证。
开通阿里云百炼的模型服务
使用阿里云主账号前往阿里云百炼大模型服务平台,如果页面顶部显示以下消息,您需要开通阿里云百炼的模型服务,以获得新人免费额度。开通阿里云百炼不会产生费用,仅模型调用(超出免费额度后)、模型部署、模型调优模型会产生相应计费。如果未显示该消息,则表示您已经开通。
如果开通服务时提示“您尚未进行实名认证”,请先进行实名认证。
获取API Key
前往API-Key页面,在我的页签(下图位置①)下单击创建我的API-KEY(下图位置②)。
在创建新的API-KEY弹窗中,选择API Key归属的业务空间,填写描述信息,并单击确定。
归属业务空间:通常使用默认业务空间即可(即主账号空间)。如果选择非默认业务空间,则后续使用该API Key调用、训练和部署模型时,需由主账号管理员授权子业务空间模型调用、训练和部署权限。
描述:建议填写具有实际意义的内容,以便准确识别API Key的用途。
在已创建的API Key操作列,单击查看(上图位置③),获取API Key。
说明仅主账号拥有查看全部API-KEY的权限。主账号可以查看/删除所有子账号的API Key,子账号仅能查看/删除自己的API Key。
请勿以任何方式公开API Key,避免因未经授权的使用导致安全风险或资金损失。
API Key是您的重要资产,请务必妥善保管。如果您单击操作列的删除将已有API Key删除,您将无法继续通过该Key访问阿里云百炼大模型提供的各项服务,如果您之前在某些应用程序或服务中集成了这个API Key,那么这些应用将会因为认证失败而无法正常工作。
下一步
获得API Key后,建议您将其配置到环境变量中,以便在调用模型或应用时使用。这样可以避免在代码中显式地配置API Key,从而降低API Key泄漏的风险。在环境变量中配置API Key的具体操作,请参见配置API Key到环境变量。
API Key的权限范围说明
主账号的API Key可以访问所有业务空间下的服务(模型部署、模型调用、模型训练等),但访问指定业务空间时,必须传入对应业务空间的“业务空间ID”。调用指定业务空间模型的具体操作,请参见子业务空间的模型调用。
子账号的API Key仅可以访问API Key绑定的业务空间下已被授权的服务(模型部署、模型调用、模型训练等)。主账号授权业务空间的具体操作,请参见授权子业务空间模型调用、训练和部署。
如果子账号想要访问“默认业务空间”(即主账号的业务空间)下的服务(模型部署、模型调用、模型训练等),有2种解决方案:
获取主账号API Key来进行调用。
主账号先给子账号授权“默认业务空间”的权限,然后子账号在“默认业务空间”下创建自己的API Key来访问“默认业务空间”下的服务。
API Key时效性说明
通过我的API-KEY页面创建的API Key默认为永久有效,手动删除后API Key将会失效。
如果您需要为第三方应用或用户提供临时访问权限,或者希望严格控制敏感数据访问、删除等高风险操作时,可以获取临时鉴权Token(有效期为60秒),避免直接暴露长期有效的API Key,降低泄露风险。