本文为您介绍大模型应用防火墙 Java SDK 的下载地址、安装方式以及初始化配置。

前提条件

• 已注册火山引擎账号并完成实名认证。具体步骤，请参见账号注册及实名认证。
• 已在火山引擎控制台开通当前服务。
• 已获取账号的AccessKey、SecretKey，具体步骤，请参见获取AccessKey、SecretKey。

环境要求

JDK 1.8 或以上版本。执行java -version可检查当前 Java 的版本信息。

注意事项

从 Java 9 及更高版本开始，javax.annotation-api不再作为 JDK 的默认组件。如果您使用的是 Java 9 或更高版本，您需要手动添加此依赖项以确保程序正常运行。

<dependency>
    <groupId>javax.annotation</groupId>
    <artifactId>javax.annotation-api</artifactId>
    <version>1.3.2</version>
</dependency>

下载 SDK

方式一 下载当前产品的 SDK

1. 新建一个 Maven 项目。
2. 在项目目录下的pom.xml中，添加如下设置，引入当前产品的 SDK 依赖。

   说明

   引入依赖后，Maven 项目管理工具会自动下载相关 jar 包。

   <dependencies>
       <dependency>
         <groupId>com.volcengine</groupId>
         <artifactId>volcengine-java-sdk-llmshield</artifactId>
         <version>0.2.31</version>
       </dependency>
   </dependencies>
   

方式二 下载所有产品的 SDK

如果您需要引入火山引擎已支持的全部云产品 SDK，可以通过 bom 方式引入。如下文所示，引入volcengine-java-sdk-bom后，即可引入所有支持的服务。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.volcengine</groupId>
            <artifactId>volcengine-java-sdk-bom</artifactId>
            <version>0.2.31</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

初始化

配置 AK 和 SK

在代码中设置您的 AK 和 SK，可直接使用主账号信息，或者通过用户管理创建子账号，并为子账号授予相应的权限。

配置服务接入地域

1. 在大模型应用防火墙控制台实例列表，查看实例所在地域。
   
2. 获取地域 ID，详情请参见 Region 列表。例如：
   • 华北 2（北京）：cn-beijing
   • 华东 2（上海）：cn-shanghai
3. 在代码中设置服务接入地域。

示例代码

完整的初始化示例代码如下：

package com.TestLLMshieldV2;

import com.volcengine.llmshield.*;

public class Moderate {
    public static void main(String[] args) {
        String myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com";  // 根据大模型应用防火墙实例所在地域替换相应的地域信息
        String ak = "YOUR AK";  // 火山账号的 AK
        String sk = "YOUR SK";  // 火山账号的 SK
        String region = "cn-beijing";  // 大模型应用防火墙实例所在地域
        String myAppID = "app-d2pgblcjslsilv******"; // 资产的 AppId，可在控制台获取
        long timeout = 5000; // 超时时间，单位毫秒
        ApiClient client = ApiClient.New(myUrl, ak,sk,region, timeout);