必须先完成阿里云实名认证并开通DashScope或百炼服务才能获取API Key：个人需上传身份证、企业需提交营业执照及法人身份证；认证通过后1–3个工作日，再分别通过AccessKey管理、百炼控制台或OpenAI兼容入口创建Key，务必立即复制保存；最后配置环境变量并运行测试代码验证调用成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要调用通义千问大模型接口，必须先拿到合法有效的API Key，否则所有请求都会返回401错误——这个密钥不是注册账号就自动发放的，得手动开通服务、实名认证、再进特定控制台创建，漏掉任一环节都会卡在“找不到入口”或“按钮灰显”状态。
完成阿里云实名认证
登录阿里云官网（aliyun.com）后，右上角头像→【实名认证】→按提示上传身份证正反面。个人用户必须本人实名，企业用户需提交营业执照+法人身份证。【未完成实名认证的账号无法生成任何AccessKey，系统不报错也不提示，只会静默拦截创建操作】。
认证提交后需等待1–3个工作日，期间无法加速或跳过。建议同步绑定手机号和邮箱，避免审核通过后收不到通知。
开通DashScope或百炼服务
实名通过后，在阿里云控制台顶部搜索框输入“DashScope”，点击进入【模型服务灵积】；或者输入“百炼”，进入【百炼大模型平台】。两个入口都可申请Key，区别在于：
• DashScope适合快速调用基础模型（如qwen-max、qwen-plus），界面简洁，开箱即用；
• 百炼更适合企业级开发，支持模型微调、应用编排、私有部署等高级能力。
首次访问任一平台，都会弹出服务开通协议，勾选并点击“立即开通”。系统自动配置权限，无需手动添加策略。
创建并保存API Key
方法一：DashScope路径
开通DashScope后，点击右上角头像→【AccessKey管理】→【创建AccessKey】。页面生成AccessKey ID和AccessKey Secret两串字符，其中AccessKey Secret仅显示一次，关闭页面即永久消失。
方法二：百炼路径
进入百炼控制台（bailian.console.aliyun.com），右上角头像→【API-Key】→【创建我的API-KEY】→勾选默认业务空间→确认。生成的Key以sk-开头，例如sk-xxxxxxxxxxxxxxxxxxxxxxxx。
方法三：OpenAI兼容模式快捷入口
直接访问 https://platform.qianwenai.com/home/api-keys ，登录后点击右上角【创建 API Key】，填个描述名称（如“本地测试”），点生成即可。该Key可用于OpenAI SDK兼容调用，endpoint为 https://dashscope.aliyuncs.com/compatible-mode/v1。
【务必立即复制保存到密码管理器，不要截图存桌面，也不要发聊天工具】。Key泄露等于账户被接管，且无法重置，只能删除重建。
配置环境变量调用API
第一步：设置环境变量
Windows（PowerShell）：$env:DASHSCOPE_API_KEY="sk-xxx"
macOS/Linux：export DASHSCOPE_API_KEY=sk-xxx
第二步：新建hello_qwen.py文件，粘贴以下代码：
import dashscope<br>from dashscope import Generation<br>response = Generation.call(model='qwen-max', prompt='你好')<br>print(response.output.text)
第三步：终端执行python hello_qwen.py。看到返回“你好”即表示Key生效、网络连通、模型调用成功。
