必须先注册阿里云账号并开通通义千问api服务，否则调用会报401错误；需实名认证、进入灵积控制台开通免费试用（50万tokens/自然月），创建accesskey并安全保管密钥，安装dashscope sdk后用最小代码验证连通性（返回200即成功），再构造含格式要求的prompt发送请求，最后解析json响应接入分析流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想用千问AI API自动处理Excel、清洗数据库、生成统计报表或批量解析问卷数据，但卡在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文件，粘贴以下最小验证代码：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
import dashscope
dashscope.api_key = "sk-你的AccessKey_Secret"
response = dashscope.Generation.call(
model='qwen-turbo',
prompt='你好'
)
print(response.status_code)
运行后若输出200，说明API通道已通；若报错403，检查密钥是否复制完整、有无多余空格；若报错429，说明当前密钥已被其他进程高频调用，需暂停或换密钥。
构造数据分析专用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画柱状图。
这一步操作起来很简单，直接把解析结果丢进已有分析管道就行，无需重写逻辑。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
