3分钟内发出第一条通义千问API请求并获取响应：准备AccessKey密钥存入.env，创建Python虚拟环境并安装requests和python-dotenv，运行main.py发送POST请求，成功返回含“output.text”的JSON即表示调用成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想用通义千问API让模型第一次“开口说话”，但面对密钥、URL、JSON格式一堆术语不知从哪下手——别翻文档了，现在就照着做，3分钟内发出第一条请求，看到返回结果。
准备API密钥和基础环境
先去阿里云控制台的「AccessKey管理」页面创建一对密钥，系统会一次性显示AccessKey ID和AccessKey Secret，【AccessKey Secret只显示一次，关闭页面后无法找回】。复制下来，存进本地项目根目录的.env文件里，写成：ACCESS_KEY_ID=your_id_here ACCESS_KEY_SECRET=your_secret_here。
用venv新建一个干净的Python环境：python -m venv qwen_env → 激活它（Windows用qwen_env\Scripts\activate.bat，macOS/Linux用source qwen_env/bin/activate）→ 运行pip install requests python-dotenv。
构造并发送第一个POST请求
新建一个main.py文件，粘贴以下代码：
import os
from dotenv import load_dotenv
import requests
load_dotenv()
API_KEY = os.getenv("ACCESS_KEY_SECRET")
URL = "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"model": "qwen-turbo",
"input": {
"prompt": "你好，请用一句话介绍你自己"
}
}
response = requests.post(URL, headers=headers, json=data)
print(response.json())
运行python main.py。如果返回中包含"output"→"text"字段，且内容是通义千问的自我介绍，说明请求成功。若报401错误，检查Authorization头里是否误用了AccessKey ID而非Secret；若报400，大概率是prompt为空或JSON结构缺逗号。
用Postman免代码快速验证
方法一：图形化填表式调用
打开Postman → 点击「New Request」→ 命名后点「Save」→ 在地址栏输入URL：https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation → 左侧选「POST」→ 点「Headers」标签页 → 添加两行：Key填Authorization，Value填Bearer + 你的AccessKey Secret（注意中间有空格）；Key填Content-Type，Value填application/json → 切到「Body」→ 选「raw」→ 右侧下拉选「JSON」→ 粘入完整请求体（含model和input字段）→ 点「Send」。
方法二：导入集合一键复用
在CSDN星图平台部署通义千问2.5镜像后，页面会自动生成Postman集合链接，点击即可导入全部预设请求，省去手动填Header和Body的步骤。这一步跳过容易漏掉Authorization头，导致反复401。
解析响应并提取有效文本
第一步：确认status_code为200，否则先看error.message字段定位问题类型。
第二步：检查返回JSON里是否有output键，没有则说明模型未触发推理，常见原因是input结构错误或model参数拼写错误（比如写成qwen_turbo少横线）。
第三步：安全提取文本——用response.json().get("output", {}).get("text", "")，避免因字段缺失导致程序崩溃。
第四步：打印结果时加一句print("AI回答：" + text.strip())，.strip()能清除模型可能附带的换行或空格，防止后续处理出错。
