Java SDK使用说明

更新时间：2024-11-05

安装Java SDK

注意：目前支持 Java版本 >= 8版本。

选择以下任一种方式安装。

在pom.xml的dependencies中添加依赖

<dependency>
    <groupId>com.baidubce</groupId>
    <artifactId>qianfan</artifactId>
    <version>0.1.1</version>
</dependency>

对于Kotlin DSL，在build.gradle.kts的dependencies中添加依赖

implementation("com.baidubce:qianfan:0.1.1")

对于Groovy DSL，在build.gradle的dependencies中添加依赖

implementation 'com.baidubce:qianfan:0.1.1'

千帆平台提供了2种鉴权方式。调用API不同，使用的鉴权方式可能不同。开发者可以根据实际使用，选择合适的方式进行调用。

（1）登录千帆ModelBuilder控制台

（2）查看安全认证Access Key/Secret Key

在安全认证/Access Key 页面，查看Access Key（即安全认证AK）、Secret Key（即安全认证SK）。

注意： 安全认证Access Key/Secret Key，和应用API Key/和 Secret Key不同。安全认证Access Key/Secret Key，更多介绍请参考如何获取AK/SK。

通过SDK调用API，SDK会获取安全认证AK和SK初始化信息，并自动完成鉴权相关步骤。

SDK支持从环境变量 QIANFAN_ACCESS_KEY 和 QIANFAN_SECRET_KEY 获取配置，这一步骤会在使用 SDK 时自动完成

export QIANFAN_ACCESS_KEY=your_access_key
export QIANFAN_SECRET_KEY=your_secret_key

Qianfan qianfan = new Qianfan("your_access_key", "your_secret_key");

调用相关API，请参考各API文档调用示例。

说明：使用此方式进行鉴权，后续可能出现新功能不兼容的情况，不推荐使用。

（1）登录千帆ModelBuilder控制台。

登录千帆ModelBuilder控制台。注意：为保障服务稳定运行，账户最好不处于欠费状态。

（2）创建应用。

注意：应用需为旧版应用，如果是V2协议模型服务接口对应的应用，无API Key和Secret Key值。

（3）在应用接入页，获取应用的API Key、Secret Key。

通过SDK调用API时，SDK会获取安全认证AK和SK初始化信息，并自动完成鉴权相关步骤。支持通过环境变量、参数设置两种初始化方式，可以选择以下任一种方式初始化。

export QIANFAN_AK=应用API Key
export QIANFAN_SK=应用Secret Key

通过调用相关接口时设置参数初始化。

Qianfan qianfan = new Qianfan(Auth.TYPE_OAUTH, "应用API Key", "应用Secret Key");

调用相关API，请参考各API文档调用示例。