成功输出“你好”即调用通义千问API成功,需完成六步:注册阿里云账号、实名认证(个人传身份证/企业传执照)、开通DashScope服务、创建AccessKey并保存密钥、配置DASHSCOPE_API_KEY环境变量、安装dashscope SDK后运行调用代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想用Python调用通义千问API,让程序输出“你好”就成功——这不需要懂模型原理、不用配服务器,只要走通注册→实名→开通→拿Key→设环境变量→跑代码这六步链路,中间任何一步卡住都会返回401错误。
完成阿里云账号注册与实名认证
打开阿里云官网(aliyun.com),点击右上角“免费注册”,用本人手机号+邮箱+密码完成基础注册。这一步必须填真实姓名和身份证号,后续所有API权限都绑定该实名主体。
登录后立刻进入【实名认证】流程:个人用户上传身份证正反面照片,企业用户需提供营业执照和法人身份证。未完成实名认证的账号无法创建有效AccessKey,【系统会直接拦截密钥生成操作,且不提示具体原因】。
认证提交后等待1–3个工作日,期间无法跳过或绕行。建议同步绑定手机号和常用邮箱,用于接收审核结果和安全通知。
开通DashScope服务并创建API密钥
实名通过后,进入阿里云控制台首页,在顶部搜索框输入“DashScope”,点击搜索结果中的“模型服务灵积(DashScope)”服务入口。
首次访问会弹出服务开通协议,勾选并点击“立即开通”。系统自动配置服务角色与基础权限,无需手动添加策略。
开通完成后,点击右上角头像→“AccessKey管理”→“创建AccessKey”。页面生成AccessKey ID和AccessKey Secret两个字符串,其中AccessKey Secret仅显示一次,关闭页面即不可再查,【务必立即复制保存到密码管理器,不要截图存桌面】。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
配置DASHSCOPE_API_KEY环境变量
方法一:终端临时设置(适合快速验证)
Windows(PowerShell):$env:DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
macOS/Linux:export DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
方法二:永久写入系统环境变量(推荐长期使用)
macOS:在~/.zshrc末尾追加 export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx",然后执行 source ~/.zshrc
Windows:系统属性→高级→环境变量→系统变量→新建→变量名填 DASHSCOPE_API_KEY,变量值填你的密钥
验证是否生效:打开Python交互环境,运行 import os; print(os.getenv("DASHSCOPE_API_KEY")),应输出完整密钥字符串。如果输出None,说明环境变量没生效,别急着跑代码。
安装SDK并运行首条调用代码
第一步:执行 pip install dashscope 安装官方SDK。注意不要装错成 qwen 或 qwen-sdk,那是旧版包,已弃用。
第二步:新建文件 hello_qwen.py,粘贴以下内容:
import dashscope
from dashscope import Generation
response = Generation.call(model='qwen-max', prompt='你好')
print(response.output.text)
第三步:在终端中执行 python hello_qwen.py。如果看到终端输出“你好”,说明API调用成功;如果报错 status_code=401,请回头检查实名认证状态和环境变量是否设置正确。

















