可行,阿里云dashscope提供openai兼容v1接口端点,只需安装openai==1.12.0、配置openai_api_key与openai_api_base环境变量、初始化client并指定qwen-turbo等兼容模型即可调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在现有项目里直接复用 OpenAI SDK 代码调用通义千问,不用重写逻辑、不换工具链、不改业务层,只改几行配置就能跑通——这完全可行,阿里云 DashScope 已提供稳定兼容的 v1 接口端点,且支持主流模型如 qwen-turbo、qwen-plus、qwen-max。
安装与版本锁定
执行 pip install openai==1.12.0。新版 openai 库(1.30+)已移除对非 OpenAI 官方 base_url 的宽松适配,【必须锁定 1.12.0 版本】,否则 client 初始化会静默失败或抛出 UnknownEndpointError。
安装完成后运行 python -c "import openai; print(openai.__version__)" 确认版本准确无误。
环境变量安全配置
在项目根目录新建 .env 文件,写入:
OPENAI_API_KEY=sk-xxx-your-dashscope-key
OPENAI_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1
注意:不要把密钥硬编码进 Python 文件;.env 文件需加入 .gitignore,防止意外提交。
初始化客户端并发起请求
第一步:导入并加载环境变量
from openai import OpenAI
import os
from dotenv import load_dotenv
load_dotenv()
第二步:创建 client 实例,base_url 必须指向兼容模式端点
client = OpenAI(
api_key=os.getenv("OPENAI_API_KEY"),
base_url=os.getenv("OPENAI_API_BASE")
)
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
第三步:调用 chat.completions.create,model 参数填 qwen-turbo 或 qwen-max
response = client.chat.completions.create(
model="qwen-turbo",
messages=[{"role": "user", "content": "你好,请用中文简单介绍你自己"}]
)
第四步:提取返回文本
print(response.choices[0].message.content.strip())
常见错误速查与绕过方案
方法一:报错 “InvalidRequestError: model does not exist”
说明你传了 dashscope 原生模型名(如 qwen-vl-chat),【兼容接口只认 qwen-turbo / qwen-plus / qwen-max】,不支持 qwen-vl、qwen-audio 等多模态变体。
方法二:返回空 content 或 status_code=401
检查 OPENAI_API_KEY 是否复制完整(开头是 sk-,长度约 48 位),DashScope 控制台中该 key 是否已启用、是否绑定正确项目。
方法三:timeout 或 connection refused
确认 base_url 是 https://dashscope.aliyuncs.com/compatible-mode/v1,不是 /api/v1 或 /v1/services ——后者是原生接口路径,不兼容 OpenAI SDK。










