千问AI API怎么发送第一条请求？

想用通义千问API让模型第一次开口说话，却卡在密钥、URL、JSON格式这些术语上？别着急，跟着下面的步骤，三分钟内就能发出第一条请求，看到返回结果。先准备好AccessKey密钥，存入.env文件，再创建一个Python虚拟环境，安装好requests和python-dotenv，最后运行一个简单的脚本，成功返回含“output.text”的JSON就表示调用成功了。

准备API密钥和基础环境

去阿里云控制台的「AccessKey管理」页面创建一对密钥，系统会一次性显示AccessKey ID和AccessKey Secret。

所以务必立刻复制下来，存进本地项目根目录的.env文件里，格式如下：

ACCESS_KEY_ID=your_id_here
ACCESS_KEY_SECRET=your_secret_here

接着用venv新建一个干净的Python环境：

python -m venv qwen_env

然后激活它——Windows执行qwen_envScriptsactivate.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」→ 命名后点「Sa ve」→ 在地址栏输入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」。如果返回结果正确，说明环境配置和密钥都无误。

解析响应并提取有效文本

拿到返回的JSON后，按以下四步确认：

第一步：确认status_code为200。如果不是，先看error.message字段定位问题类型。

第二步：检查返回JSON里是否有output键。没有则说明模型未触发推理，常见原因是input结构错误或model参数拼写错误（比如写成qwen_turbo少了横线）。

第三步：安全提取文本——用response.json().get("output", {}).get("text", "")，避免因字段缺失导致程序崩溃。

第四步：打印结果时加一句print("AI回答：" + text.strip())，.strip()能清除模型可能附带的换行或空格，防止后续处理出错。