欢迎来到 AI 的世界！本文将带你一步步完成阿里通义千问 Qwen3 模型的安装和首次使用。你不需要任何 AI 基础，只要会基本的电脑操作和一点点编程概念就够了。

准备环境：你需要什么？

• Python：一种编程语言，很多 AI 工具都用它。如果你还没安装，去 python.org 下载最新版本，安装时记得勾选“Add Python to PATH”。
• pip：Python 的包管理工具，用来安装库。一般装 Python 时会自动带上。
• OpenAI 库：Qwen3 的 API 兼容 OpenAI 格式，所以我们需要安装 openai 库。在终端运行：pip install openai
• API 密钥：你需要去阿里云或其他平台申请一个 Qwen3 的 API 密钥。申请后记下密钥，后面会用到。

安装步骤：一行代码搞定

1. 打开终端（Windows 是命令提示符或 PowerShell，Mac 是终端）。
2. 输入以下命令安装 OpenAI 库：pip install openai。如果提示权限问题，可以加 --user 或使用虚拟环境。
3. 等待安装完成。看到“Successfully installed”就表示成功了。

验证是否成功：第一次调用 Qwen3

写一小段 Python 代码来测试。新建一个文件 test_qwen.py，复制以下内容：

from openai import OpenAI

client = OpenAI(
    api_key="你的API密钥",  # 替换成你的密钥
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"  # Qwen3 的接口地址
)

response = client.chat.completions.create(
    model="qwen-turbo",  # 最便宜的模型，适合测试
    messages=[{"role": "user", "content": "你好，请用一句话介绍自己"}]
)

print(response.choices[0].message.content)

保存后，在终端运行：python test_qwen.py。如果看到模型回复了文字，恭喜你，第一次调用成功！

常见坑提醒：如果报错“ModuleNotFoundError”，说明 openai 库没装好，重新运行 pip install openai。如果报错“401”，说明 API 密钥填错了，检查一下。

下一步可以做什么？

• 试试其他模型：把 model 改成 qwen-plus 或 qwen-coder-14b（后者擅长写代码）。
• 多轮对话：在 messages 列表里添加更多轮次的消息。
• 流式输出：设置 stream=True 让回复一个字一个字显示出来，体验更流畅。

现在你已经入门了，接下来可以探索更多 Qwen3 的功能，比如图片理解（VL 模型）或代码生成。祝你在 AI 世界里玩得开心！