目录一、为什么选择阿里云百炼二、第一步获取你的 API Key1. 开通阿里云百炼服务下面有链接2. 创建 API Key3.使用API Key三、第二步配置 API Key两种方法任你选方法 1配置为系统环境变量推荐方法 2使用本地 .env 文件四、第三步用 OpenAI SDK 调用通义千问1. 安装依赖2. 完整示例代码3. 运行效果大家好今天给大家带来一篇超详细的教程教你如何从 0 开始在阿里云百炼平台获取 API Key并通过 OpenAI SDK 来调用通义千问大模型。全程无坑新手也能一次跑通一、为什么选择阿里云百炼阿里云百炼DashScope提供了通义千问等一系列大模型服务并且它完美兼容 OpenAI 的 API 接口。这意味着你可以直接使用熟悉的openai SDK 来调用通义千问学习成本几乎为零同时享受国内稳定的服务和低廉的价格。二、第一步获取你的 API Key调用大模型的第一步就是拿到 “钥匙”。1. 开通阿里云百炼服务下面有链接https://bailian.console.aliyun.com/cn-beijing/?spm5176.29597918.nav-v2-dropdown-menu-0.d_main_1_0_0.52ca133cUAgwHatabhomescm20140722.M_10992489._.V_1#/home1. 访问阿里云百炼控制台使用你的阿里云账号登录。2. 首次登录会提示你开通服务并同意协议直接点击同意即可。◦ 如果提示需要实名认证请先完成账号的实名认证。2. 创建 API Key前往阿里云百炼控制台首页在页面右上角选择华北2北京地域进入 API Key 页面单击创建API Key在弹窗中配置以下信息并单击确定 ◦ 归属业务空间建议选择默认业务空间。 ◦ 权限建议选择全部若有更精细的权限控制需求可以选择自定义来控制使用 API Key 的 IP 白名单。点击 API Key 旁的图标获取该 API Key。 主账号可以查看全部 API Key子账号仅能查看自己创建的 API Key。3.使用API Key方式一在第三方工具中调用模型 如果在 Chatbox 等工具或平台中调用模型您可能需要输入三个信息 ◦ 本文获取的API Key ◦ API Key 所属地域的 Base URL■ 华北2北京 https://dashscope.aliyuncs.com/compatible-mode/v1■ 新加坡 https://dashscope-intl.aliyuncs.com/compatible-mode/v1■ 美国弗吉尼亚 https://dashscope-us.aliyuncs.com/compatible-mode/v1 ◦ 模型名称如qwen-plus 常用工具配置Chatbox、Cline、Claude Code、Dify、OpenClaw原 Clawdbot/Moltbot、Postman、Qwen Code。方式二通过代码调用模型 通过代码首次调用千问API建议配置 API Key 到环境变量以避免硬编码在代码中导致泄露风险。 请勿以任何方式公开API Key避免因未经授权的使用导致安全风险或资金损失。API Key时效性说明创建的 API Key 没有失效日期手动删除后即失效。 若需为第三方应用或用户提供临时访问权限或需严格控制敏感数据访问、删除等高风险操作可生成临时 API Key有效期 60 秒避免暴露长期有效的 API Key降低泄露风险。三、第二步配置 API Key两种方法任你选为了避免把 API Key 直接写在代码里非常不安全我们推荐以下两种方式来配置它。方法 1配置为系统环境变量推荐这种方式最安全所有项目都能调用且不会泄露你的 Key。在 Windows 上右键点击【此电脑】→【属性】→【高级系统设置】→【环境变量】。在【系统变量】中点击【新建】。变量名填写DASHSCOPE_API_KEY变量值填写你刚才复制的 API Keysk-xxxxxx。一路点击【确定】保存。重要配置完成后重启你的 IDE如 PyCharm、VS Code新的环境变量才会生效方法 2使用本地.env文件如果不想修改系统环境变量可以在项目根目录创建一个.env文件。在你的 Python 项目文件夹下新建一个名为.env的文件。在文件中写入envDASHSCOPE_API_KEYsk-xxxxxx在代码中使用python-dotenv库来加载它python运行from dotenv import load_dotenv import os # 加载.env文件中的环境变量 load_dotenv() api_key os.getenv(DASHSCOPE_API_KEY)别忘了先安装库pip install python-dotenv四、第三步用 OpenAI SDK 调用通义千问现在我们用最熟悉的 OpenAI 代码来调用阿里云的模型1. 安装依赖首先确保你安装了openai库bash运行pip install openai2. 完整示例代码这里有一个可以直接运行的脚本帮你快速验证配置是否成功。python运行from openai import OpenAI import os # ------------------- 配置客户端 ------------------- # 从环境变量中读取API Key如果配置了系统环境变量可以省略这行 # api_key os.getenv(DASHSCOPE_API_KEY) client OpenAI( # 如果配置了系统环境变量这里可以省略api_key参数 api_keysk-xxxxxx, # 替换成你的API Key仅测试用不推荐硬编码 base_urlhttps://dashscope.aliyuncs.com/compatible-mode/v1, # 阿里云百炼的兼容地址 ) # ------------------- 调用模型 ------------------- completion client.chat.completions.create( modelqwen-plus, # 你可以换成其他模型如 qwen-turbo, qwen-7b-chat等 messages[ {role: system, content: You are a helpful assistant.}, {role: user, content: 你是谁} ] ) # ------------------- 打印结果 ------------------- # 完整的原始JSON结构 print(completion.model_dump_json()) # 仅输出对话内容 print(\n---\n) print(completion.choices[0].message.content)3. 运行效果运行上面的代码如果一切配置正确你将在控制台看到类似这样的输出json{ id: chatcmpl-xxx, choices: [ { finish_reason: stop, index: 0, message: { content: 你好我是通义千问Qwen阿里巴巴集团旗下的超大规模语言模型。我能够回答问题、创作文字比如写故事、写公文、写邮件、写剧本、逻辑推理、编程等等还能表达观点玩游戏等。如果你有任何问题或需要帮助欢迎随时告诉我, role: assistant } } ], usage: { completion_tokens: 66, prompt_tokens: 22, total_tokens: 88 } } --- 你好我是通义千问Qwen阿里巴巴集团旗下的超大规模语言模型。我能够回答问题、创作文字比如写故事、写公文、写邮件、写剧本、逻辑推理、编程等等还能表达观点玩游戏等。如果你有任何问题或需要帮助欢迎随时告诉我进程已结束退出代码 0这代表你已经成功调用了通义千问大模型