使用 OpenAI SDK 调用阿里云 Qwen 模型：从入门到实战

随着大语言模型（LLM）的快速发展，越来越多的国产模型已经具备媲美甚至超越国际模型的能力。
阿里云的 通义千问（Qwen） 系列便是其中的佼佼者。

本文将详细介绍如何使用 OpenAI 官方 SDK（openai 包），在完全不修改调用逻辑的前提下，直接调用 阿里云 Qwen 模型（如 qwen-plus）。

我们不仅会运行完整示例代码，还将深入分析其执行逻辑、API 参数、错误处理及优化方式，帮助你快速构建属于自己的智能对话应用。

---

🧩 一、为什么选择 Qwen + OpenAI SDK 组合？

以往在使用国内大模型时，开发者常常需要：

• 学习不同厂商的 SDK；

• 适配多种 API 接口格式；

• 调整参数与响应解析逻辑。

而现在，阿里云 DashScope 提供了与 OpenAI 兼容的 API 模式。
这意味着你可以在几乎不改动代码的情况下，将原本使用 GPT-3.5 / GPT-4 的程序迁移到 Qwen 模型上。

✅ 优势对比

特性	Qwen Plus	GPT-4-turbo
调用接口	完全兼容 OpenAI SDK	原生支持
延迟	平均降低 30%	稍高
成本	较低	较高
支持地域	北京 / 新加坡	全球
本地化理解	优秀（中文语义与常识）	中等
适配生态	LangChain、OpenAI SDK	原生

因此，对于希望在中文场景中实现 高性价比、低延迟 的开发者来说，Qwen + OpenAI SDK 是理想选择。

---

⚙️ 二、环境准备

确保你已经安装了以下依赖：

pip install openai

然后在阿里云控制台中创建 API Key：

🔗 获取 API Key（阿里云 Model Studio）

⚠️ 提示：
阿里云的 Key 分为“北京地域”与“新加坡地域”，调用时需选择对应的 base_url。

---

💻 三、完整示例代码

下面是一段可以直接运行的完整示例，展示了如何让模型判断“奇数之和是否为偶数”：

import os
from openai import OpenAI

# ========================
# 1. 初始化客户端
# ========================
client = OpenAI(
    # 新加坡和北京地域的API Key不同
    # 推荐使用环境变量方式加载，防止泄露
    # api_key=os.getenv("DASHSCOPE_API_KEY"),
    api_key="sk-",
    # 北京地域 base_url，若为新加坡请改为：
    # https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

# ========================
# 2. 多轮对话调用示例
# ========================
response = client.chat.completions.create(
    # 模型选择
    model="qwen-plus",
    messages=[
        {
            "role": "user",
            "content": "该组中的奇数加起来为偶数：1、2、3、4、5、6、7，对吗？"
        },
        {
            "role": "assistant",
            "content": "所有奇数相加等于16。答案为是。"
        },
        {
            "role": "user",
            "content": "该组中的奇数加起来为偶数：17、10、19、4、8、12、24、3，对吗？"
        },
        {
            "role": "assistant",
            "content": "所有奇数相加等于39，答案为否。"
        },
        {
            "role": "user",
            "content": "该组中的奇数加起来为偶数：15、12、5、3、72、17、1，对吗？像上面一样回答我"
        },
    ]
)
print(response.choices[0].message.content)
print("**********")

# ========================
# 3. 分步推理（CoT）调用
# ========================
response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {
            "role": "user",
            "content": "该组中的奇数加起来为偶数：15、12、5、3、72、17、1，对吗？让我们来分步思考。"
        }
    ]
)
print(response.choices[0].message.content)

---

🧠 四、运行逻辑与结果分析

(1) 调用结构说明

参数	说明
model	指定使用的模型（如 qwen-plus、qwen-turbo）
messages	对话历史，用于提供上下文
role	消息角色，可为 user、assistant、system
content	实际对话内容

(2) 输出示例

运行结果类似于：

所有奇数相加等于41。答案为否。
**********
让我们分步思考：
奇数为15、5、3、17、1，它们的和为41，是奇数，因此总和不是偶数，答案为否。

可以看到：

• 模型不仅正确计算了奇数的总和；

• 还能在第二次调用中清晰展示“逐步推理过程（Chain of Thought）”。

这说明 Qwen 在逻辑运算与解释性任务上的能力表现优异。

---

🧰 五、代码优化与安全建议

1️⃣ 环境变量方式存放 API Key

强烈建议使用系统环境变量来保护密钥安全：

import os
api_key = os.getenv("DASHSCOPE_API_KEY")

在命令行中设置：

export DASHSCOPE_API_KEY="your_api_key"

---

2️⃣ 增加错误处理机制

在生产场景中，网络波动或调用超时较为常见，可添加异常捕获：

try:
    response = client.chat.completions.create(model="qwen-plus", messages=messages)
    print(response.choices[0].message.content)
except Exception as e:
    print(f"接口调用失败：{e}")

---

3️⃣ 调整模型参数

若需控制模型的回答风格与创造性，可以指定以下参数：

response = client.chat.completions.create(
    model="qwen-plus",
    temperature=0.7,   # 创造性
    max_tokens=512,    # 限制生成长度
    top_p=0.9,         # 采样多样性
    messages=messages
)

---

🌏 六、Qwen 模型生态与应用场景

应用方向	模型优势	示例
智能问答	中文语义理解强	客服问答、健康咨询系统
代码生成	支持 Python、C++、Java 等语言	自动补全与代码解释
数据分析	支持自然语言查询	智能 SQL 生成
文本创作	逻辑性强、表达自然	新闻生成、报告撰写
教育与推理	Chain-of-Thought 推理能力优异	数学题、逻辑题解释

通义千问模型已支持主流框架（LangChain、LlamaIndex、FastAPI 等），非常适合构建 RAG 智能问答系统 或 行业知识助手。

---

🧩 七、总结与扩展方向

本文完整演示了如何使用 OpenAI SDK 调用阿里云 Qwen 模型，包括：

• ✅ 初始化客户端与配置 base_url；

• ✅ 多轮对话与上下文保持；

• ✅ 分步推理（Chain-of-Thought）；

• ✅ 异常处理与参数优化；

• ✅ 应用场景与生态对接。

👉 你可以在此基础上扩展为：

• 自动答题机器人；

• 智能报告分析系统；

• 面向企业的专属知识问答引擎；

• 与 LangChain 结合的检索增强生成（RAG）系统。