通义千问API快速上手：获取Key与Python调用示例

阿澈

发布时间：2026-10-20| 15人浏览过

原创

对于希望将大语言模型能力集成到应用中的开发者而言，通义千问提供了标准的API接口。接入过程主要涉及两个环节：在云平台控制台完成服务开通与鉴权配置，以及在本地开发环境中编写调用代码。本文将引导你完成从获取密钥到运行第一个对话请求的全过程。

概述

整个接入流程可以概括为“云端配置”与“本地编码”两部分。首先在阿里云百炼控制台创建API Key作为身份凭证，随后在Python项目中安装SDK并配置密钥，最后通过几行代码发起对话。这种分离设计确保了密钥管理的安全性，同时保持了调用的简洁性。

通义千问API快速上手：获取Key与Python调用示例

阿里云百炼控制台主界面，展示左侧导航栏与核心功能入口

关于【控制台开通与Key获取】

在使用API之前，需要拥有阿里云账号并开通百炼服务。登录阿里云百炼控制台后，左侧导航栏通常包含“模型广场”或“API-KEY管理”等入口。不同时期的界面布局可能略有调整，但核心逻辑一致：找到密钥管理区域。

进入API-KEY管理页面后，点击“创建新的API-KEY”。系统会生成一串以sk-开头的字符序列，这是后续所有请求的身份凭证。请注意，该密钥仅在创建时完整显示一次，务必妥善保存。建议将其复制到剪贴板或临时记事本中，避免直接硬编码在代码文件里。

通义千问API快速上手：获取Key与Python调用示例

API-KEY管理页面，显示创建按钮及密钥隐藏状态

关于【环境变量配置】

为了安全起见，推荐通过环境变量传递API Key，而不是直接写在代码中。这样即使代码被公开，密钥也不会泄露。

在Windows系统中，可以通过命令行设置临时变量：

set DASHSCOPE_API_KEY=你的API-Key

在macOS或Linux系统中，使用export命令：

export DASHSCOPE_API_KEY=你的API-Key

如果在IDE如PyCharm或VS Code中开发，也可以在项目的运行配置（Run Configuration）或.env文件中设置该变量。确保在运行Python脚本前，当前终端会话已加载该环境变量。

通义千问API快速上手：获取Key与Python调用示例

关于【环境变量配置】

关于【Python SDK安装】

通义千问官方提供了DashScope SDK，简化了HTTP请求的构造过程。打开终端或命令提示符，使用pip进行安装：

pip install dashscope

安装完成后，可以在Python环境中导入dashscope模块来验证安装是否成功。如果未报错，说明环境准备就绪。

通义千问API快速上手：获取Key与Python调用示例

关于【Python SDK安装】

关于【最小化调用代码】

以下是一个基于Python的最简调用示例，使用qwen-turbo模型进行对话。代码首先读取环境变量中的Key，然后构建消息列表并发起调用。

import os
from http import HTTPStatus
import dashscope

# 从环境变量获取API Key
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")

def call_qwen():
    messages = [
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你好，请介绍一下你自己'}
    ]
    
    response = dashscope.Generation.call(
        model='qwen-turbo',
        messages=messages,
        result_format='message'  # 设置返回格式为message
    )
    
    if response.status_code == HTTPStatus.OK:
        print(response.output.choices[0].message.content)
    else:
        print(f"Error: {response.code} - {response.message}")

if __name__ == '__main__':
    call_qwen()

通义千问API快速上手：获取Key与Python调用示例