安装 SDK

千问云提供 DashScope SDK（Python、Java），同时兼容 OpenAI SDK 调用。OpenAI 提供 Python、Node.js、Java 和 Go SDK。

环境准备

如果本地已安装 Python、Java、Node.js 或 Go，可跳过本节。

Python
Java
Node.js
Go

检查 Python 版本

检查 Python 和 pip 是否已安装：

python -V
pip --version

需要 Python 3.8 及以上版本。如未安装，请前往 python.org 下载。

`python -V` 或 `pip --version` 提示"command not found"？

Windows
Linux and macOS

安装 Python 并添加到 PATH。参见安装 Python。
安装 Python 并设置 PATH 后仍报错，请重启终端后重试。

安装 Python。参见安装 Python。
如果仍报错，检查 python 和 pip 是否存在：
- 输出显示 /usr/bin/python 和 /usr/bin/pip，重启终端即可。
- 显示 "no python"，尝试 which python3 pip3：

/usr/bin/which: no python in (/root/.local/bin:/root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin)
/usr/bin/which: no pip in (/root/.local/bin:/root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin)

如果找到 /usr/bin/python3 和 /usr/bin/pip3，请使用 python3 -V 和 pip3 --version。

/usr/bin/python3
/usr/bin/pip3

配置虚拟环境（可选）

建议创建虚拟环境来隔离 SDK 依赖。

创建虚拟环境

创建名为 .venv 的虚拟环境：

# 如果命令执行失败，可将 python 替换为 python3 后重试。
python -m venv .venv

激活虚拟环境

激活虚拟环境：

Windows:

.venv\Scripts\activate

macOS/Linux:

source .venv/bin/activate

检查 Java 版本

在终端运行以下命令：

java -version
# （可选）如果使用 Maven，检查是否已安装
mvn --version

需要 Java 8 及以上版本。如未安装，请前往 Java Downloads 下载。

检查 Go 版本

在终端运行以下命令：

go version

如未安装 Go，请前往 Go 官网下载。

OpenAI Go SDK 需要 Go 1.22 及以上版本。

创建项目并初始化模块

创建项目文件夹并初始化模块：

# 创建项目文件夹（请根据操作系统调整路径和命令）
mkdir D:\your_project_folder && cd /d D:\your_project_folder

# 初始化模块。example.com 仅为示例，任意同格式名称均可，无需真实域名。
go mod init example.com/your_project_folder

Python
Java
Node.js
Go

可通过 OpenAI Python SDK 或 DashScope Python SDK 调用千问云 API。

安装 OpenAI Python SDK

安装 OpenAI Python SDK：

# 如果命令执行失败，可将 pip 替换为 pip3 后重试。
pip install -U openai

安装成功提示：Successfully installed ... openai-x.x.x

安装 DashScope Python SDK

安装 DashScope Python SDK：

# 如果命令执行失败，可将 pip 替换为 pip3 后重试。
pip install -U dashscope

安装成功提示：Successfully installed ... dashscope-x.x.x

pip 版本警告可忽略。

安装 DashScope Java SDK

添加 DashScope Java SDK 依赖。将 the-latest-version 替换为最新版本号。

XML

打开 Maven 项目的 pom.xml 文件。
在 <dependencies> 标签中添加以下依赖：

<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>dashscope-sdk-java</artifactId>
  <!-- 将 'the-latest-version' 替换为最新版本号，参见：https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
  <version>the-latest-version</version>
</dependency>

保存 pom.xml 文件。
运行 Maven 命令（如 mvn compile 或 mvn clean install）更新依赖。Maven 会自动下载并添加 DashScope Java SDK 到项目中。

IntelliJ IDEA 示例：

Gradle

打开 Gradle 项目的 build.gradle 文件。
在 dependencies 代码块中添加以下依赖：

dependencies {
    // 将 'the-latest-version' 替换为最新版本号，参见：https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
    implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: 'the-latest-version'
}

保存 build.gradle 文件。
在项目根目录运行以下命令更新依赖：

./gradlew build --refresh-dependencies

IntelliJ IDEA 示例：

安装 OpenAI Java SDK

添加 OpenAI Java SDK 依赖。

XML

打开 Maven 项目的 pom.xml 文件。
在 <dependencies> 标签中添加以下依赖（版本 4.30.0+）：

<dependency>
  <groupId>com.openai</groupId>
  <artifactId>openai-java</artifactId>
  <version>4.30.0</version>
</dependency>

保存 pom.xml 文件。
运行 Maven 命令（如 mvn compile 或 mvn clean install）更新项目依赖。Maven 会自动下载并添加 OpenAI Java SDK 到项目中。

通过 npm 或 yarn 安装：

npm install --save openai
# or
yarn add openai

如果安装失败，配置镜像源：

npm config set registry https://registry.npmmirror.com/

然后重新安装。

安装成功提示：added xx package in xxs。查看版本：npm list openai

安装 OpenAI Go SDK：

go get github.com/openai/openai-go/v3@v3.30.0

安装成功提示：go: added github.com/openai/openai-go/v3 v3.30.0

该 SDK 处于 beta 阶段，v3.30.0 版本已通过功能验证。
如果服务器超时，请使用镜像：

# 设置镜像
go env -w GOPROXY=https://goproxy.cn,direct

后续步骤

运行 OpenAI SDK 或 DashScope SDK 的代码示例。

​环境准备

检查 Python 版本

python -V 或 pip --version 提示"command not found"？

配置虚拟环境（可选）

​安装 SDK

安装 OpenAI Python SDK

安装 DashScope Python SDK

​后续步骤

环境准备

`python -V` 或 `pip --version` 提示"command not found"？

安装 SDK

后续步骤