必须先获取合法API密钥、安装DashScope SDK、选择合适模型并构造合规请求，缺一不可，否则返回401/400错误；密钥需在灵积平台创建并绑定FullAccess权限，SDK调用需清洗输入、限制长度，Web部署须避免硬编码并添加限流防护。

要用千问AI API让程序调用通义千问大模型能力，必须先拿到合法API密钥、装好官方SDK、选对模型、构造合规请求——缺一不可，否则会直接返回401或400错误。

在灵积平台申请并安全配置API密钥

第一步：打开阿里云灵积平台，用主账号登录。

第二步：左侧导航栏点击「API密钥管理」→「创建新的API密钥」→勾选协议后确认生成。

第三步：页面弹出的API Key值（以sk-开头）【必须完整复制且仅显示一次】，立即存入密码管理器或环境变量，切勿截图、明文写进代码、发到GitHub。

第四步：回到控制台，在「访问控制」中为该Key绑定「DashScope FullAccess」权限策略，否则调用时仍会报错403。

安装DashScope SDK并验证连接

终端执行：pip install dashscope

新建文件test_qwen.py，填入以下内容：

import dashscope
dashscope.api_key = "sk-xxx" # 替换为你的真实密钥
from dashscope import Generation
resp = Generation.call(model="qwen-turbo", prompt="你好")
print(resp.output.text if resp.status_code == 200 else "失败：" + str(resp.status_code))

运行python test_qwen.py。若输出“你好”或类似正常回复，说明SDK与密钥均有效；若报错Invalid API Key，请检查密钥是否复制完整、有无空格、是否过期。

按任务选模型并构造请求参数

方法一：轻量对话/快速响应 → 用qwen-turbo

方法二：复杂推理/长文本分析 → 用qwen-max或qwen-long

方法三：多模态理解（图文输入）→ 必须用qwen-vl，且请求体需含image_url字段，普通文本模型不支持图片解析。

注意：用户输入必须做清洗——移除x00-x08、x0B、x0C、x0E-x1F等控制字符，否则触发400 Bad Request；单次请求prompt长度建议≤3000字符，超长需分段或启用streaming模式。

用Flask部署Web服务并添加防护

第一步：新建app.py，导入Flask和dashscope。

第二步：设置环境变量加载密钥：os.environ["DASHSCOPE_API_KEY"] = os.getenv("API_KEY")，避免硬编码。

第三步：定义路由，接收POST请求，提取request.json.get("prompt")，调用Generation.call()，返回response.output.text。

第四步：加入基础限流——用flask-limiter限制每IP每分钟5次调用，防止密钥泄露后被滥刷。

第五步：启动服务：flask run --host=0.0.0.0 --port=5000，前端即可通过fetch("/api/chat", {method:"POST", body:JSON.stringify({prompt:"..."})})发起调用。