使用阿里云百炼的大模型或应用前,请先获取API Key作为鉴权凭证。
一、获取API Key
前往API Key(新加坡)、API Key(弗吉尼亚)或API Key(北京)页面,单击创建API KEY。
在弹窗中配置以下信息,并单击确定:
归属账号:建议选择主账号。
归属业务空间:建议选择默认业务空间。
点击API Key旁的
图标获取该API Key。主账号可以查看全部API Key,子账号仅能查看自己创建的API Key。

二、使用API Key
方式一:在第三方工具中调用模型
如果在Chatbox等工具或平台中调用模型,您可能需要输入三个信息:
本文获取的API Key
API Key所属地域的Base URL:
新加坡:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1美国(弗吉尼亚):
https://dashscope-us.aliyuncs.com/compatible-mode/v1华北2(北京):
https://dashscope.aliyuncs.com/compatible-mode/v1
模型名称,如qwen-plus
常用工具配置:Chatbox、Cline、Claude Code、Dify、OpenClaw(原 Clawdbot/Moltbot)、Postman、Qwen Code。
方式二:通过代码调用模型
通过代码首次调用千问API,建议配置API Key到环境变量,以避免硬编码在代码中导致泄露风险。
请勿以任何方式公开API Key,避免因未经授权的使用导致安全风险或资金损失。
API Key权限说明
API Key的调用权限完全由其归属业务空间决定。同一空间内的API Key权限相同,无需为不同模型(如文生文、文生图、语音合成)创建不同的API Key。
API Key时效性说明
创建的API Key永久有效,手动删除后即失效。
若需为第三方应用或用户提供临时访问权限,或需严格控制敏感数据访问、删除等高风险操作,可生成临时 API Key(有效期60秒),避免暴露长期有效的API Key,降低泄露风险。
常见问题
Q:单个主账号下最多能创建多少个API Key?
A:每个主账号下最多可创建10个业务空间(包括默认业务空间),每个业务空间下最多可创建20个API Key。
Q:RAM用户被删除后,其创建的API Key是否依然可用?
A:在RAM控制台中禁用或删除RAM用户后,其创建的所有API Key均将失效,无法再用于模型调用。