在正式调用前，以下步骤缺一不可：先注册阿里云账号，并开通通义千问 API 服务，否则接口调用大概率会直接返回 401 错误；随后完成实名认证，进入灵积控制台领取免费试用额度（50万Tokens/自然月），再创建 AccessKey，并将密钥安全保存。接下来安装 dashscope SDK，使用一段最小化示例代码先验证接口连通性，返回 200 即表示调用链路已打通；确认无误后，再编写带有明确格式要求的 Prompt 发起请求，最后解析 JSON 响应结果，并接入后续数据分析或自动化处理流程。
如果你想通过千问AI API自动处理 Excel、清洗数据库、生成统计报表，或者批量解析问卷数据，却卡在 API 调用这一步，不清楚该从哪里开始配置、如何传递数据、以及怎样让返回结果无缝对接现有分析流程，那么下面这套通义千问 API 接入方法会更适合你快速上手。
注册阿里云账号并开通通义千问API服务
这一步必须先完成，否则后续所有调用代码基本都会报 401 错误。通义千问 API 不支持游客身份调用，也不提供临时密钥访问方式。
打开阿里云官网 → 使用手机号注册账号并完成实名认证 → 登录后进入「模型服务灵积」控制台 → 在产品列表中找到「通义千问」→ 点击「立即开通」→ 选择免费试用（新用户通常默认赠送 50 万 Tokens）。
需要注意的是：免费额度按自然月重置，并非按天累积；如果当月额度已经用完，需要手动充值，或者等待次月 1 日系统自动恢复。
创建并安全保管API密钥
进入「AccessKey管理」页面 → 点击「创建AccessKey」→ 下载 CSV 文件后立即保存到本地加密目录，【切勿截图、勿存桌面、勿上传网盘】。
AccessKey ID 用于身份标识，AccessKey Secret 则是私钥，一旦泄露，几乎等同于账户权限被接管。DashScope SDK 通常会自动读取环境变量中的密钥，因此不建议将密钥硬编码到 Python 脚本中，以降低安全风险。
复制好 AccessKey ID 和 Secret，准备进入下一步配置与调用。
安装SDK并验证基础连通性
在终端执行：pip install dashscope。如果提示 PermissionError，可追加--user参数完成安装。
新建 Python 文件，粘贴以下最小化验证代码：
先引入 dashscope，然后将 dashscope.api_key 设置为你的 "sk-你的AccessKey_Secret"。接着调用 dashscope.Generation.call(
response = dashscope.Generation.call(
model='qwen-turbo',
prompt='你好'
)
最后使用 print(response.status_code) 输出本次请求的返回状态码。
运行后如果输出 200，说明通义千问 API 通道已经打通；如果报错 403，请检查密钥是否完整复制、是否包含多余空格；如果报错 429，则说明当前密钥可能已被其他进程高频调用，需要暂停请求或更换密钥再试。
构造数据分析专用Prompt并发送请求
仅用普通文本提问，通常无法稳定触发结构化输出，因此必须在 Prompt 中显式声明格式要求。例如分析销售数据时，不要只写“分析一下销售额”，而应该写得更具体：
“你是一个资深财务分析师。请基于以下CSV数据（第一行为字段名：日期,产品,销售额,地区），执行：①计算总销售额、平均单日销售额；②找出销售额最高的3个产品及对应金额；③按地区汇总销售额并排序。结果必须以JSON格式返回，键名为total_sales、avg_daily、top3_products、region_summary，其中top3_products为对象数组，region_summary为键值对字典。”
将原始数据内容（建议不超过 2000 字符）拼接在 prompt 末尾，并使用三引号包裹。若数据长度超过限制，可先通过 pandas 进行抽样、筛选或聚合后再传入模型。
解析响应并写入分析流程
第一步：检查response.output.text是否为合法 JSON 字符串。如果不是，通常说明模型没有严格按照指令格式输出，此时需要在 prompt 中强化“必须”“严格”“不得添加解释文字”等约束表达。
第二步：使用json.loads()解析返回文本。若解析失败，可打印原始 text，排查是否存在中文标点、隐藏换行符，或 Markdown 符号等干扰内容。
第三步：将解析后的字典传给下游处理函数——例如用pandas.DataFrame(region_summary.items())转换为表格，或结合matplotlib生成柱状图。
这一步实际操作并不复杂，直接把解析结果接入现有分析管道即可，通常无需额外重写整体业务逻辑。