千问AI兼容OpenAI SDK怎么调用

梦墨君_4917

梦墨君_4917

2026-07-24

933人浏览

原创

可行,阿里云dashscope提供openai兼容v1接口端点,只需安装openai==1.12.0、配置openai_api_key与openai_api_base环境变量、初始化client并指定qwen-turbo等兼容模型即可调用。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

千问ai兼容openai sdk怎么调用

你想在现有项目里直接复用 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")
)

Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more

统一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。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
ChatGPT注册
ChatGPT注册

ChatGPT注册方法:1、访问OpenAI的官方网站,进入注册页面;2、完成注册后收到一份邮件,打开后点击验证账号;3、选择一个适合您需求的订阅计划;4、获得访问ChatGPT的权限即可。

2023.09.12

1853

9

国内免费ChatGPT大全
国内免费ChatGPT大全

ChatGPT是一种基于深度学习技术的自然语言处理模型,由OpenAI开发。它是GPT的一个变体,专门设计用于生成上下文相关的文本回复。ChatGPT被训练成一个聊天机器人,可以与用户进行对话交互。更多关于ChatGPT的文章详情请查看本专题,希望对大家能有所帮助。

2023.10.25

4425

20

手机安装chatgpt的方法
手机安装chatgpt的方法

手机安装chatgpt的方法:1、在ChatGTP官网或手机商店上下载ChatGTP软件;2、打开后在设置界面中,选择语言为中文;3、在对局界面中,选择人机对局并设置中文相谱;4、开始后在聊天窗口中输入指令,即可与软件进行交互。想了解更多chatgpt的相关内容,可以阅读本专题下面的文章。

2024.03.05

7681

9

chatgpt国内可不可以使用
chatgpt国内可不可以使用

chatgpt在国内可以使用,但不能注册,港澳也不行,用户想要注册的话,可以使用国外的手机号进行注册,注意注册过程中要将网络环境切换成国外ip。想了解更多chatgpt的相关内容,可以阅读本专题下面的文章。

2024.03.05

3136

10

chatgpt官网入口地址合集
chatgpt官网入口地址合集

本专题整合了chatgpt官网入口地址、使用教程等内容,阅读专题下面的文章了解更多详细内容。

2026.03.16

1758

24

chatgpt使用指南
chatgpt使用指南

本专题整合了chatgpt使用教程、新手使用说明等等相关内容,阅读专题下面的文章了解更多详细内容。

2026.03.16

497

20

ChatGPT编程开发实战教程
ChatGPT编程开发实战教程

本专题全面讲解ChatGPT在编程开发中的应用,包括代码生成、接口调试、Bug修复、前端页面开发、Python脚本编写及数据库优化等,帮助开发者提升效率。

2026.05.29

180

14

ChatGPT自媒体创作教程
ChatGPT自媒体创作教程

本专题聚焦ChatGPT在自媒体领域的应用,包括爆款标题生成、短视频脚本撰写、小红书文案优化、公众号排版及AI创意输出等内容,适合内容创作者与运营人员学习。

2026.05.29

199

15

ChatGPT零基础入门教程
ChatGPT零基础入门教程

本专题适合ChatGPT新手用户学习,内容涵盖账号注册、基础功能、提示词使用、插件工具、聊天技巧及常见问题处理,帮助快速掌握ChatGPT核心操作。

2026.05.29

457

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ChatGPT入门手册
ChatGPT入门手册

共0课时 | 0人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习