安装SDK

更新时间:2025-02-17 09:45:13

阿里云百炼官方提供了PythonJava编程语言的SDK,也提供了与OpenAI兼容的调用方式。本文为您介绍如何安装OpenAI SDK以及DashScope SDK。

操作步骤

Python
Node.js
Java

步骤一:检查您的Python版本

您可以在终端中输入以下命令查看当前计算环境是否安装了Pythonpip:

您的Python需要为3.8或以上版本,请您参考安装Python进行安装。

python -V
pip --version

WindowsCMD为例:

image

常见问题

Q:执行python -Vpip --version报错:

  • 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件。

  • 'pip' 不是内部或外部命令,也不是可运行的程序或批处理文件。

  • -bash: python: command not found

  • -bash: pip: command not found

解决办法如下:

Windows系统
Linux、macOS系统
  1. 请确认是否已参考安装Python,在您的计算环境中安装Python,并将python.exe添加至环境变量PATH中。image

  2. 如果已安装了Python并添加了环境变量,仍报此错,请关闭当前终端,重新打开一个新的终端窗口,再进行尝试。

  1. 请确认是否已参考安装Python,在您的计算环境中安装的Python。

  2. 如果已安装Python后,仍报此错,请输入which python pip命令查询系统中是否有pythonpip

    • 如果返回如下结果,请关闭当前连接终端,重新打开一个新的终端窗口,再进行尝试。

      /usr/bin/python
      /usr/bin/pip
    • 如果返回如下结果,则再次输入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)

      如果返回结果如下,则使用python3 -Vpip3 --version查询版本。

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

步骤二:配置虚拟环境(可选)

如果您的Python已安装完成,可以创建一个虚拟环境来安装OpenAI Python SDKDashScope Python SDK,这可以帮助您避免与其它项目发生依赖冲突。

  1. 创建虚拟环境

    您可以运行以下命令,创建一个命名为.venv的虚拟环境:

    # 如果运行失败,您可以将python替换成python3再运行
    python -m venv .venv
  2. 激活虚拟环境

    如果您使用Windows系统,请运行以下命令来激活虚拟环境:

    .venv\Scripts\activate

    如果您使用macOS或者Linux系统,请运行以下命令来激活虚拟环境:

    source .venv/bin/activate

步骤三:安装OpenAI Python SDKDashScope Python SDK

您可以通过OpenAIPython SDKDashScopePython SDK来调用百炼平台上的模型。

安装OpenAI Python SDK
安装DashScope Python SDK

通过运行以下命令安装OpenAI Python SDK:

# 如果运行失败,您可以将pip替换成pip3再运行
pip install -U openai

image

当终端出现Successfully installed ... openai-x.x.x的提示后,表示您已经成功安装OpenAI Python SDK。

通过运行以下命令安装DashScope Python SDK:

# 如果运行失败,您可以将pip替换成pip3再运行
pip install -U dashscope

image

当终端出现Successfully installed ... dashscope-x.x.x的提示后,表示您已经成功安装DashScope Python SDK。

步骤一:检查Node.js安装状态

您可以在终端中输入以下命令查看当前计算环境是否安装了Node.jsnpm:

node -v
npm -v

WindowsCMD为例:

image

这将打印出您当前Node.js 版本。如果您的环境中没有Node.js,请访问Node.js官网进行下载。

步骤二:安装SDK

您可以在终端运行以下命令:

npm install --save openai
# 或者
yarn add openai
说明

如果安装失败,您可以通过配置镜像源的方法来完成安装,如:

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

配置镜像源后,您可以重新运行安装SDK的命令。

image

当终端出现added xx package in xxs的提示后,表示您已经成功安装OpenAI SDK。您可以使用npm list openai查询具体版本信息。

步骤一:检查您的Java版本

您可以在终端运行以下命令:

java -version
# (可选)如果使用maven管理和构建java项目,还需确保maven已正确安装到您的开发环境中
mvn --version

WindowsCMD为例:

image

为了使用DashScope Java SDK,您的Java需要在Java 8或以上版本。您可以查看打印信息中的第一行确认Java版本,例如打印信息:openjdk version "16.0.1" 2021-04-20表明当前Java版本为Java 16。如果您当前计算环境没有Java,或版本低于Java 8,请前往Java下载进行下载与安装。

步骤二:安装DashScope Java SDK

如果您的环境中已安装Java,请安装DashScope Java SDK。SDK的版本请参考:DashScope Java SDK。执行以下命令来添加 Java SDK 依赖,并将 the-latest-version 替换为最新的版本号。

XML
Gradle
  1. 打开您的Maven项目的pom.xml文件。

  2. <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>
  3. 保存pom.xml文件。

  4. 使用Maven命令(如mvn compilemvn clean install)来更新项目依赖,这样Maven会自动下载并添加DashScope Java SDK到您的项目中。

WindowsIDEA集成开发环境为例:

image

  1. 打开您的Gradle项目的build.gradle文件。

  2. 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'
    }
  3. 保存build.gradle文件。

  4. 在命令行中,切换到您的项目根目录,执行以下Gradle命令来更新项目依赖。这将会自动下载并添加DashScope Java SDK到您的项目中。

    ./gradlew build --refresh-dependencies

WindowsIDEA集成开发环境为例:

image

下一步

模型调用文档中,运行OpenAI兼容或DashScope SDK的代码示例。

相关参考

OpenAI SDK支持的模型,请参考OpenAI接口兼容

  • 本页导读 (1)
  • 操作步骤
  • 下一步
  • 相关参考
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等