本文为您介绍大模型应用防火墙 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

在 Maven 项目的 pom.xml 文件中，添加如下设置，引入当前产品的 SDK 依赖。

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

方式二：下载所有产品的 SDK

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

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

初始化

大模型应用防火墙支持接收代理服务的请求信息，如果你的大模型业务使用了代理服务器来转发或接收客户端请求，可以在初始化大模型应用防火墙时配置代理相关参数，确保其能正确处理代理服务的请求信息。
不同场景的初始化示例代码如下，其中：

• myUrl、ak、sk、appid 和 region 参数的详细说明，参考关键参数说明。
• 如果有代理服务配置需求，需在 ApiClient.New(myUrl, ak, sk, region, timeout, proxy, connMax); 中，传入代理地址 proxy 和最大连接数 connMax。如果无需使用代理服务，则无需传入 proxy 和 connMax。

不同场景下，完整的初始化示例代码如下：

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); // 初始化大模型应用防火墙客户端

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, "http://10.37.**.**:8888", 100); // 初始化大模型应用防火墙客户端，其中 "http://10.37.**.**:8888" 为代理地址示例值、100 为最大连接数示例值