首次调用通义千问 API 的全攻略

在这个充满科技感的时代，人工智能已经成为我们生活中不可或缺的一部分。阿里云推出的通义千问 API，提供了强大的大语言模型调用能力，让我们能够轻松构建智能应用。本文将带领您一步一步完成首次调用通义千问 API 的过程，助您快速上手。

🛠️ 开通服务与获取 API Key

首先，您需要注册或登录阿里云账号，然后前往模型广场开通模型服务。这是获取 API Key 的第一步，API Key 就像是您通往通义千问的“门票”，没有它，您将无法顺利调用 API。

🔑 创建 API Key

在 API Key 管理界面，您可以创建新的 API Key。请务必妥善保管，避免将其明文写入代码中，以免造成泄露。这就好比保管您的银行密码，安全第一！

🖥️ 配置本地开发环境

在开始调用 API 之前，您需要配置好本地开发环境。根据您的编程语言的不同，步骤可能会有所不同。以下是针对 Python 的配置步骤。

🐍 Python 环境配置

1. 检查 Python 版本：在终端中输入以下命令查看您的 Python 版本：

   python -V
   

   确保您的 Python 版本是 3.8 或以上。如果没有安装，请参考相关文档进行安装。

2. 创建虚拟环境（可选）：为了避免与其他项目发生依赖冲突，建议您创建一个虚拟环境：

   python -m venv .venv
   

3. 激活虚拟环境：

   • Windows 系统：

     .venv\Scripts\activate
     

   • macOS 或 Linux 系统：

     source .venv/bin/activate
     

4. 安装 SDK：您可以选择安装 OpenAI 的 Python SDK 或 DashScope 的 Python SDK。

   pip install -U openai
   

   或者

   pip install -U dashscope
   

⚙️ 配置环境变量

配置完 SDK 后，接下来是设置 API Key 为环境变量。环境变量的设置方式因操作系统而异。

🪟 Windows 系统

在 CMD 中添加 API Key 为环境变量：

setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"

🐧 Linux 或 macOS

在终端中添加 API Key 为环境变量：

export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

为了使其在新的会话中生效，可以将上述命令添加到 ~/.bashrc​或 ~/.zshrc​文件中。

📞 调用通义千问 API

完成环境配置后，您就可以开始调用通义千问 API。如您选择使用 Python SDK，以下是一个简单的示例代码：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
    model="qwen-turbo",
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ],
    temperature=0.8
)

print(completion.choices[0].message.content)

🖥️ 运行代码

将上述代码保存为 hello_qwen.py​，在终端中运行：

python hello_qwen.py

您将看到如下输出：

我是阿里云开发的一款超大规模语言模型，我叫通义千问。

🌐 结语

通过以上步骤，您已经成功调用了通义千问 API，体验了大语言模型的强大能力。无论是开发聊天机器人、智能问答还是其他应用，通义千问都能够为您提供强有力的支持。未来，期待您在这条智能化的道路上越走越远！

参考文献

1. 阿里云帮助中心. (2024). 首次调用通义千问 API.
2. Python 官方文档. (2023). Python 安装与配置.
3. OpenAI Python SDK 文档. (2023). SDK 安装指南.
4. DashScope 文档. (2023). API 调用指南.
5. 阿里云大模型服务平台. (2024). 模型广场介绍.