大模型应用防火墙
大模型应用防火墙
- 文档首页
大模型应用防火墙SDK 参考多模态混合检测
复制全文
下载 pdf多模态混合检测
文档反馈
问问助手您可以基于大模型应用防火墙 SDK 调用接口，同时对文本、图片以及文档内容进行检测，该能力称为多模态混合检测。本文提供 Python、Java、Go、PHP 开发语言的多模态混合检测示例代码，供您参考。
注意事项
- 前置依赖：参考SDK 安装和初始化完成依赖安装和初始化配置。
- 接口说明：接口介绍、使用限制以及参数描述，请参见检测输入或输出内容是否合规。
- 版本要求：
- 语言版本pythonJavaGoPHP
无代理服务
Python
Java
Go
PHP
import sys
from volcenginesdkllmshield import *
import base64
# 文档Base64编码
def load_file_content(file_type, file_path):
with open(file_path, 'rb') as f:
file_bytes = f.read()
baseStr = base64.b64encode(file_bytes).decode('utf-8')
if file_type == "doc":
baseStr = "data:application/msword;base64," + baseStr
elif file_type == "docx":
baseStr = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + baseStr
elif file_type == "txt":
baseStr = "data:text/plain;base64," + baseStr
elif file_type == "xls":
baseStr = "data:application/vnd.ms-excel;base64," + baseStr
elif file_type == "xlsx":
baseStr = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + baseStr
elif file_type == "pdf":
baseStr = "data:application/pdf;base64," + baseStr
print(f"", baseStr)
return baseStr
# 图片Base64编码
def load_image_content(image_file):
with open(image_file, 'rb') as f:
img_bytes = f.read()
base64_bytes = base64.b64encode(img_bytes).decode('utf-8')
return base64_bytes, len(base64_bytes)
def main():
# 配置信息（请替换为实际值）
myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" # 根据大模型应用防火墙实例所在地域替换相应的地域信息
ak = "YOUR AK" # 火山账号的 AK
sk = "YOUR SK" # 火山账号的 SK
appid = "app-d3r06khsqn9s73da****" # 资产的 AppId，可在控制台资产管理页面获取
region = "cn-beijing" # 大模型应用防火墙实例所在地域
TIMEOUT = 50 # 超时时间（秒）
# 文本检测示例内容
content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."
# 图片检测示例内容
image_file = "/Users/example/imagedemo.png" # 待检测图片的本地存储路径
image_content, size = load_image_content(image_file)
# 确保图片大小不超过 10 MB
if size > 1010241024:
print(f"请求失败: {size/1024}KB")
return
# 文档检测示例内容
file_content = load_file_content("docx", "/Users/example/filedemo.docx") # 待检测文档的格式和本地存储路径
try:
# 发送请求并获取响应
client = ClientV2(myUrl, ak, sk, region, TIMEOUT)
# 多模态混合检测文本、图片和文档内容
contTxt = MultiPart(content = content, content_type = ContentTypeV2.TEXT)
contimg = MultiPart(content = image_content, content_type = ContentTypeV2.IMAGE)
contFile = MultiPart(content = file_content, content_type = ContentTypeV2.FILE)
# 构建请求（使用 pydantic 模型）
request = ModerateV2Request(
scene=appid, # 资产的 AppId
message=MessageV2(
role="user", # 检测的内容来源，user-用户提示词；assistant-模型响应内容
multi_part = [contTxt, contimg, contFile], # 待检测的文本、图片和文档内容
),
)
response = client.Moderate(request)
# 使用 pydantic 的内置序列化方法
print("审核结果（JSON格式）:")
print(response.model_dump_json(by_alias=True, indent=2)) # pydantic 模型直接转 JSON
except Exception as e:
print(f"请求失败: {e}")
if __name__ == "__main__":
main()
package com.example;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Base64;
import com.volcengine.llmshield.*;
public class Main {
// 文档Base64编码
public static String encodeFileToBase64(String ftype, String filepath) throws IOException {
File file = new File(filepath);
try (FileInputStream fis = new FileInputStream(file)) {
byte[] fileBytes = new byte[(int) file.length()];
fis.read(fileBytes);
String baseStr = Base64.getEncoder().encodeToString(fileBytes);
switch (ftype) {
case "doc":
baseStr = "data:application/msword;base64," + baseStr;
break;
case "docx":
baseStr = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + baseStr;
break;
case "txt":
baseStr = "data:text/plain;base64," + baseStr;
break;
case "xls":
baseStr = "data:application/vnd.ms-excel;base64," + baseStr;
break;
case "xlsx":
baseStr = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + baseStr;
break;
case "pdf":
baseStr = "data:application/pdf;base64," + baseStr;
break;
}
System.out.println("baseStr: " + baseStr);
return baseStr;
}
}
// 图片Base64编码
public static String convertImageToBase64(String imagePath) throws IOException {
File file = new File(imagePath);
try (FileInputStream fis = new FileInputStream(file)) {
byte[] imageBytes = new byte[(int) file.length()];
fis.read(imageBytes);
return Base64.getEncoder().encodeToString(imageBytes);
}
}
public static void main(String[] args) throws IOException {
String myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; //根据大模型应用防火墙实例所在地域替换相应的地域信息
String ak = "YOUR AK"; // 火山账号的 AK
String sk = "YOUR SK"; // 火山账号的 SK
String myAppID = "app-d3r06khsqn9s73da****"; // 资产的 AppId，可在控制台资产管理页面获取
String region = "cn-beijing"; // 大模型应用防火墙实例所在地域
long timeout = 5000; // 超时时间，单位毫秒
ApiClient client = ApiClient.New(myUrl, ak, sk, region, timeout); // 初始化大模型应用防火墙客户端
ModerateV2Request request = new ModerateV2Request();
request.setScene(myAppID);
String txt_content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."; // 文本检测示例内容
String image_content = "/Users/example/imagedemo.png"; // 图片检测示例内容，传入图片本地存储路径
String file_content = "/Users/example/filedemo.docx"; // 文档检测示例内容，传入文档本地存储路径
try {
// 确保图片大小不超过 10 MB
int flen =image_content.length();
if (flen > 10 * 1024 * 1024) {
System.out.println("Content size bigger than system:" + flen/1024 + "KB");
return;
}
// 设置检测内容
MessageV2 message = new MessageV2();
message.setRole("user"); // 检测的内容来源，user-用户提示词；assistant-模型响应内容
// 多模态混合检测文本
MultiPart contPartTxt = new MultiPart();
contPartTxt.setContent(txt_content);
contPartTxt.setContentType(ContentTypeV2.TEXT);
message.appendMultiPart(contPartTxt);
// 多模态混合检测图片
MultiPart contPartImage = new MultiPart();
contPartImage.setContent(convertImageToBase64(image_content));
contPartImage.setContentType(ContentTypeV2.IMAGE);
message.appendMultiPart(contPartImage);
// 多模态混合检测文档
MultiPart contPartFile = new MultiPart();
contPartFile.setContent(encodeFileToBase64("docx",file_content));
contPartFile.setContentType(ContentTypeV2.FILE);
message.appendMultiPart(contPartFile);
request.setMessage(message);
} catch (IOException e) {
System.err.println("转换失败:" + e.getMessage());
e.printStackTrace();
}
try {
// 调用 Moderate 接口进行检查
ModerateV2Response response = client.Moderate(request);
if (response != null) {
System.out.println("response: " + response);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
package main
import (
"encoding/base64"
"fmt"
"os"
"strings"
"time"
"github.com/volcengine/volcengine-go-sdk/service/llmshield"
)
var (
role = "user" // 待检测内容来源，user-用户输入，assistant-模型输出
datainfo = "网上都说A地很多骗子和小偷，他们的典型伎俩..."
datainfo1 = "/Users/example/imagedemo.png" // 待检测图片的路径
datainfo2 = "/Users/example/filedemo.docx" // 待检测文档的路径
dataMap = map[string]*DcInfo{
// 待检测内容的具体格式及文件类型，支持混合检测
datainfo: {"", llmshield.ContentTypeV2_TEXT},
datainfo1: {"png", llmshield.ContentTypeV2_IMAGE},
datainfo2: {"docx", llmshield.ContentTypeV2_FILE},
//datainfo3: {"pdf", llmshield.ContentTypeV2_FILE},
//datainfo4: {"txt", llmshield.ContentTypeV2_FILE},
//datainfo5: {"xlsx", llmshield.ContentTypeV2_FILE},
//datainfo6: {"doc", llmshield.ContentTypeV2_FILE},
//datainfo7: {"xls", llmshield.ContentTypeV2_FILE},
//datainfo8: {"mp3", llmshield.ContentTypeV2_AUDIO},
//datainfo9: {"avi", llmshield.ContentTypeV2_VIDEO},
}
)
func main() {
var response *llmshield.ModerateV2Response
var err error
ak := "YOUR AK" // 火山账号的 AK
sk := "YOUR SK" // 火山账号的 SK
appid := "app-d7nghjo2pj8m2d2s****" // 资产的 AppID，可在控制台资产管理页面获取
region := "cn-beijing" // 大模型应用防火墙实例所在地域
myUrl := "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" // 大模型应用防火墙实例的访问地址，根据地域替换
timeout := time.Second * 20 // 超时时间
// 创建客户端实例（通过 NewAdvanced 支持配置代理和连接池大小）
client := llmshield.New(myUrl, ak, sk, region, timeout)
if client == nil {
fmt.Printf("Failed to create client instance\n")
return
}
request := llmshield.ModerateV2Request{Message: nil, Scene: appid}
request.Message = filledMsgContent(role)
response, err = client.Moderate(&request)
if err != nil {
fmt.Printf("Error occurred while checking LLM response stream: %v\n", err)
}
if response == nil {
fmt.Println("Received empty result")
}
fmt.Printf("Received result: %s\n", response.String())
}
func filledMsgContent(role string) *llmshield.MessageV2 {
var (
err error
content string
)
msg_multi := &llmshield.MessageV2{
Role: role,
}
for dataInfo, cGroup := range dataMap {
switch cGroup.Dtype {
case llmshield.ContentTypeV2_TEXT:
content = dataInfo
case llmshield.ContentTypeV2_IMAGE, llmshield.ContentTypeV2_FILE, llmshield.ContentTypeV2_AUDIO, llmshield.ContentTypeV2_VIDEO:
content, err = encodeFileToBase64(cGroup.ftype, dataInfo)
if err != nil {
fmt.Printf("Failed to encode file content:%v,err:%v\n", content, err)
}
}
multPart := &llmshield.MultiPart{
Content: content,
ContentType: cGroup.Dtype,
}
msg_multi.MultiPart = append(msg_multi.MultiPart, multPart)
}
return msg_multi
}
func encodeFileToBase64(ftype string, filePath string) (string, error) {
data, err := os.ReadFile(filePath)
if err != nil {
return "", fmt.Errorf("读取文件失败: %v", err)
}
base64Str := base64.StdEncoding.EncodeToString(data)
// 根据文件类型添加 data URI 头
switch strings.ToLower(ftype) {
case "jpg", "jpeg", "jpe":
base64Str = "data:image/jpeg;base64," + base64Str
case "png":
base64Str = "data:image/png;base64," + base64Str
case "gif":
base64Str = "data:image/gif;base64," + base64Str
case "bmp":
base64Str = "data:image/bmp;base64," + base64Str
case "tiff", "tif":
base64Str = "data:image/tiff;base64," + base64Str
case "webp":
base64Str = "data:image/webp;base64," + base64Str
case "svg", "svg+xml":
base64Str = "data:image/svg+xml;base64," + base64Str
case "ico":
base64Str = "data:image/x-icon;base64," + base64Str
case "heic":
base64Str = "data:image/heic;base64," + base64Str
case "heif":
base64Str = "data:image/heif;base64," + base64Str
case "doc":
base64Str = "data:application/msword;base64," + base64Str
case "docx":
base64Str = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + base64Str
case "ppt":
base64Str = "data:application/vnd.ms-powerpoint;base64," + base64Str
case "pptx":
base64Str = "data:application/vnd.openxmlformats-officedocument.presentationml.presentation;base64," + base64Str
case "pdf":
base64Str = "data:application/pdf;base64," + base64Str
case "txt":
base64Str = "data:text/plain;base64," + base64Str
case "xls":
base64Str = "data:application/vnd.ms-excel;base64," + base64Str
case "xlsx":
base64Str = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + base64Str
// 常见音频格式
case "mp3", "mpeg":
base64Str = "data:audio/mpeg;base64," + base64Str
case "wav":
base64Str = "data:audio/wav;base64," + base64Str
// 常见视频格式
case "mp4":
base64Str = "data:video/mp4;base64," + base64Str
case "avi":
base64Str = "data:video/x-msvideo;base64," + base64Str
}
if len(base64Str) > 50 {
fmt.Printf("Headfile: %v\n", strings.Split(base64Str[:50], "base64,")[0])
}
return base64Str, nil
}
type DcInfo struct {
ftype string
Dtype llmshield.ContentTypeV2
}
<?php
// 引入 vendor 自动加载文件（用于 GuzzleHttp 等依赖）
require __DIR__ . "/vendor/autoload.php";
use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;
// 文档Base64编码
function load_file_content($ftype, $filePath) {
if (!file_exists($filePath) || !is_readable($filePath)) {
trigger_error("文件不存在或无法读取：{$filePath}", E_USER_ERROR);
return false;
}
$fileHandle = fopen($filePath, 'rb'); // rb = 只读 + 二进制模式（必须！）
if (!$fileHandle) {
trigger_error("无法打开文件：{$filePath}", E_USER_ERROR);
return false;
}
$binaryContent = fread($fileHandle, filesize($filePath));
fclose($fileHandle); // 务必关闭文件句柄
$base64Content = base64_encode($binaryContent);
switch ($ftype) {
case "txt":
$base64Content = "data:text/plain;base64," . $base64Content;
break;
case "doc":
$base64Content = "data:application/msword;base64," . $base64Content;
break;
case "docx":
$base64Content = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," . $base64Content;
break;
case "xls":
$base64Content = "data:application/vnd.ms-excel;base64," . $base64Content;
break;
case "xlsx":
$base64Content = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," . $base64Content;
break;
case "pdf":
$base64Content = "data:application/pdf;base64," . $base64Content;
break;
}
return $base64Content;
}
// 图片Base64编码
function load_image_content($image_file) {
if (!file_exists($image_file)) {
throw new Exception("图片文件不存在: $image_file");
}
$image_data = file_get_contents($image_file);
$base64_content = base64_encode($image_data);
$size = strlen($base64_content);
return [$base64_content, $size];
}
// 配置信息
$myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; // 根据大模型应用防火墙实例所在地域替换相应的地域信息
$ak = "YOUR AK"; // 火山账号的 AK
$sk = "YOUR SK"; // 火山账号的 SK
$appid = "app-d2pgblcjslsilv******"; // 资产的 AppId，可在控制台资产管理页面获取
$region = "cn-beijing"; // 大模型应用防火墙实例所在地域
$timeout = 60; // 超时时间（秒）
$service = "llmshield"; // 服务名称
// 初始化客户端
$client = new LLMShieldApi($myUrl, $ak, $sk, $appid, $region, $timeout, $service);
$request = new Model\ModerateV2Request();
$request->Scene = $appid;
$request->Message = new Model\MessageV2();
$request->Message->Role = "user"; // 检测的内容来源，user-用户提示词；assistant-模型响应内容
// 多模态混合检测文本
$part_content = new Model\MultiPart();
$part_content->Content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."; // 示例文本
$part_content->ContentType = Model\ContentTypeV2::TEXT;
// 多模态混合检测图片
$part_image = new Model\MultiPart();
list($image_base64, $image_size) = load_image_content("/Users/example/imagedemo.png"); // 待检测的图片本地存储路径
$part_image->Content = $image_base64;
$part_image->ContentType = Model\ContentTypeV2::IMAGE;
// 多模态混合检测文档
$part_file = new Model\MultiPart();
$part_file->Content = load_file_content("docx", "/Users/example/filedemo.docx"); // 待检测的文档格式与本地存储路径
$part_file->ContentType = Model\ContentTypeV2::FILE;
echo $part_file->Content . "\n";
$request->Message->MultiPart = [$part_content, $part_image, $part_file];
$client->Moderate($request)->then(function ($resp) {
echo json_encode($resp[0], JSON_UNESCAPED_UNICODE) . "\n";
echo $resp[1] . "\n";
echo json_encode($resp[2], JSON_UNESCAPED_UNICODE) . "\n";
})->wait();
有代理服务
Python
Java
Go
PHP
import sys
from volcenginesdkllmshield import *
import base64
# 文档Base64编码
def load_file_content(file_type, file_path):
with open(file_path, 'rb') as f:
file_bytes = f.read()
baseStr = base64.b64encode(file_bytes).decode('utf-8')
if file_type == "doc":
baseStr = "data:application/msword;base64," + baseStr
elif file_type == "docx":
baseStr = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + baseStr
elif file_type == "txt":
baseStr = "data:text/plain;base64," + baseStr
elif file_type == "xls":
baseStr = "data:application/vnd.ms-excel;base64," + baseStr
elif file_type == "xlsx":
baseStr = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + baseStr
elif file_type == "pdf":
baseStr = "data:application/pdf;base64," + baseStr
print(f"", baseStr)
return baseStr
# 图片Base64编码
def load_image_content(image_file):
with open(image_file, 'rb') as f:
img_bytes = f.read()
base64_bytes = base64.b64encode(img_bytes).decode('utf-8')
return base64_bytes, len(base64_bytes)
def main():
# 配置信息（请替换为实际值）
myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" # 根据大模型应用防火墙实例所在地域替换相应的地域信息
ak = "YOUR AK" # 火山账号的 AK
sk = "YOUR SK" # 火山账号的 SK
appid = "app-d3r06khsqn9s73da****" # 资产的 AppId，可在控制台资产管理页面获取
region = "cn-beijing" # 大模型应用防火墙实例所在地域
TIMEOUT = 50 # 超时时间（秒）
# 设置代理服务字典，格式为 {"协议": "代理地址"}
proxy_dict = {"http": "http://10.37.**.**:8888"}
# 文本检测示例内容
content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."
# 图片检测示例内容
image_file = "/Users/example/imagedemo.png" # 待检测图片的本地存储路径
image_content, size = load_image_content(image_file)
# 确保图片大小不超过 10 MB
if size > 1010241024:
print(f"请求失败: {size/1024}KB")
return
# 文档检测示例内容
file_content = load_file_content("docx", "/Users/example/filedemo.docx") # 待检测文档的格式和本地存储路径
try:
# 发送请求并获取响应
client = ClientV2(myUrl, ak, sk, region, TIMEOUT)
# 设置代理地址
client.SetProxy(proxy_dict)
# 设置最大连接数，例如 100
client.SetConnMax(100)
# 多模态混合检测文本、图片和文档内容
contTxt = MultiPart(content = content, content_type = ContentTypeV2.TEXT)
contimg = MultiPart(content = image_content, content_type = ContentTypeV2.IMAGE)
contFile = MultiPart(content = file_content, content_type = ContentTypeV2.FILE)
# 构建请求（使用 pydantic 模型）
request = ModerateV2Request(
scene=appid, # 资产的 AppId
message=MessageV2(
role="user", # 检测的内容来源，user-用户提示词；assistant-模型响应内容
multi_part = [contTxt, contimg, contFile], # 待检测的文本、图片和文档内容
),
)
response = client.Moderate(request)
# 使用 pydantic 的内置序列化方法
print("审核结果（JSON格式）:")
print(response.model_dump_json(by_alias=True, indent=2)) # pydantic 模型直接转 JSON
except Exception as e:
print(f"请求失败: {e}")
if __name__ == "__main__":
main()
package com.example;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Base64;
import com.volcengine.llmshield.*;
public class Main {
// 文档Base64编码
public static String encodeFileToBase64(String ftype, String filepath) throws IOException {
File file = new File(filepath);
try (FileInputStream fis = new FileInputStream(file)) {
byte[] fileBytes = new byte[(int) file.length()];
fis.read(fileBytes);
String baseStr = Base64.getEncoder().encodeToString(fileBytes);
switch (ftype) {
case "doc":
baseStr = "data:application/msword;base64," + baseStr;
break;
case "docx":
baseStr = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + baseStr;
break;
case "txt":
baseStr = "data:text/plain;base64," + baseStr;
break;
case "xls":
baseStr = "data:application/vnd.ms-excel;base64," + baseStr;
break;
case "xlsx":
baseStr = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + baseStr;
break;
case "pdf":
baseStr = "data:application/pdf;base64," + baseStr;
break;
}
System.out.println("baseStr: " + baseStr);
return baseStr;
}
}
// 图片Base64编码
public static String convertImageToBase64(String imagePath) throws IOException {
File file = new File(imagePath);
try (FileInputStream fis = new FileInputStream(file)) {
byte[] imageBytes = new byte[(int) file.length()];
fis.read(imageBytes);
return Base64.getEncoder().encodeToString(imageBytes);
}
}
public static void main(String[] args) throws IOException {
String myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; //根据大模型应用防火墙实例所在地域替换相应的地域信息
String ak = "YOUR AK"; // 火山账号的 AK
String sk = "YOUR SK"; // 火山账号的 SK
String myAppID = "app-d3r06khsqn9s73da****"; // 资产的 AppId，可在控制台资产管理页面获取
String region = "cn-beijing"; // 大模型应用防火墙实例所在地域
long timeout = 5000; // 超时时间，单位毫秒
ApiClient client = ApiClient.New(myUrl, ak, sk, region, timeout, "http://10.37.**.**:8888", 100); // 初始化大模型应用防火墙客户端，其中 "http://10.37.**.**:8888" 为代理地址示例值、100 为最大连接数示例值
ModerateV2Request request = new ModerateV2Request();
request.setScene(myAppID);
String txt_content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."; // 文本检测示例内容
String image_content = "/Users/example/imagedemo.png"; // 图片检测示例内容，传入图片本地存储路径
String file_content = "/Users/example/filedemo.docx"; // 文档检测示例内容，传入文档本地存储路径
try {
// 确保图片大小不超过 10 MB
int flen =image_content.length();
if (flen > 10 * 1024 * 1024) {
System.out.println("Content size bigger than system：" + flen/1024 + "KB");
return;
}
// 设置检测内容
MessageV2 message = new MessageV2();
message.setRole("user"); // 检测的内容来源，user-用户提示词；assistant-模型响应内容
// 多模态混合检测文本
MultiPart contPartTxt = new MultiPart();
contPartTxt.setContent(txt_content);
contPartTxt.setContentType(ContentTypeV2.TEXT);
message.appendMultiPart(contPartTxt);
// 多模态混合检测图片
MultiPart contPartImage = new MultiPart();
contPartImage.setContent(convertImageToBase64(image_content));
contPartImage.setContentType(ContentTypeV2.IMAGE);
message.appendMultiPart(contPartImage);
// 多模态混合检测文档
MultiPart contPartFile = new MultiPart();
contPartFile.setContent(encodeFileToBase64("docx",file_content));
contPartFile.setContentType(ContentTypeV2.FILE);
message.appendMultiPart(contPartFile);
request.setMessage(message);
} catch (IOException e) {
System.err.println("转换失败:" + e.getMessage());
e.printStackTrace();
}
try {
// 调用 Moderate 接口进行检查
ModerateV2Response response = client.Moderate(request);
if (response != null) {
System.out.println("response: " + response);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
package main
import (
"encoding/base64"
"fmt"
"os"
"strings"
"time"
"github.com/volcengine/volcengine-go-sdk/service/llmshield"
)
var (
role = "user" // 待检测内容来源，user-用户输入，assistant-模型输出
datainfo = "网上都说A地很多骗子和小偷，他们的典型伎俩..."
datainfo1 = "/Users/example/imagedemo.png" // 待检测图片的路径
datainfo2 = "/Users/example/filedemo.docx" // 待检测文档的路径
dataMap = map[string]*DcInfo{
// 待检测内容的具体格式及文件类型，支持混合检测
datainfo: {"", llmshield.ContentTypeV2_TEXT},
datainfo1: {"png", llmshield.ContentTypeV2_IMAGE},
datainfo2: {"docx", llmshield.ContentTypeV2_FILE},
//datainfo3: {"pdf", llmshield.ContentTypeV2_FILE},
//datainfo4: {"txt", llmshield.ContentTypeV2_FILE},
//datainfo5: {"xlsx", llmshield.ContentTypeV2_FILE},
//datainfo6: {"doc", llmshield.ContentTypeV2_FILE},
//datainfo7: {"xls", llmshield.ContentTypeV2_FILE},
//datainfo8: {"mp3", llmshield.ContentTypeV2_AUDIO},
//datainfo9: {"avi", llmshield.ContentTypeV2_VIDEO},
}
)
func main() {
var response *llmshield.ModerateV2Response
var err error
ak := "YOUR AK" // 火山账号的 AK
sk := "YOUR SK" // 火山账号的 SK
appid := "app-d7nghjo2pj8m2d2s****" // 资产的 AppID，可在控制台资产管理页面获取
region := "cn-beijing" // 大模型应用防火墙实例所在地域
myUrl := "https://cn-beijing.sdk.access.llm-shield.omini-shield.com" // 大模型应用防火墙实例的访问地址，根据地域替换
timeout := time.Second * 20 // 超时时间
// 创建客户端实例（通过 NewAdvanced 支持配置代理和连接池大小）
client := llmshield.NewAdvanced(myUrl, ak, sk, region, timeout, "http://10.37.**.**:8888", 100) // 其中 "http://10.37.**.**:8888" 为代理地址示例值、100 为最大连接数示例值
if client == nil {
fmt.Printf("Failed to create client instance\n")
return
}
request := llmshield.ModerateV2Request{Message: nil, Scene: appid}
request.Message = filledMsgContent(role)
response, err = client.Moderate(&request)
if err != nil {
fmt.Printf("Error occurred while checking LLM response stream: %v\n", err)
}
if response == nil {
fmt.Println("Received empty result")
}
fmt.Printf("Received result: %s\n", response.String())
}
func filledMsgContent(role string) *llmshield.MessageV2 {
var (
err error
content string
)
msg_multi := &llmshield.MessageV2{
Role: role,
}
for dataInfo, cGroup := range dataMap {
switch cGroup.Dtype {
case llmshield.ContentTypeV2_TEXT:
content = dataInfo
case llmshield.ContentTypeV2_IMAGE, llmshield.ContentTypeV2_FILE, llmshield.ContentTypeV2_AUDIO, llmshield.ContentTypeV2_VIDEO:
content, err = encodeFileToBase64(cGroup.ftype, dataInfo)
if err != nil {
fmt.Printf("Failed to encode file content:%v,err:%v\n", content, err)
}
}
multPart := &llmshield.MultiPart{
Content: content,
ContentType: cGroup.Dtype,
}
msg_multi.MultiPart = append(msg_multi.MultiPart, multPart)
}
return msg_multi
}
func encodeFileToBase64(ftype string, filePath string) (string, error) {
data, err := os.ReadFile(filePath)
if err != nil {
return "", fmt.Errorf("读取文件失败: %v", err)
}
base64Str := base64.StdEncoding.EncodeToString(data)
// 根据文件类型添加 data URI 头
switch strings.ToLower(ftype) {
case "jpg", "jpeg", "jpe":
base64Str = "data:image/jpeg;base64," + base64Str
case "png":
base64Str = "data:image/png;base64," + base64Str
case "gif":
base64Str = "data:image/gif;base64," + base64Str
case "bmp":
base64Str = "data:image/bmp;base64," + base64Str
case "tiff", "tif":
base64Str = "data:image/tiff;base64," + base64Str
case "webp":
base64Str = "data:image/webp;base64," + base64Str
case "svg", "svg+xml":
base64Str = "data:image/svg+xml;base64," + base64Str
case "ico":
base64Str = "data:image/x-icon;base64," + base64Str
case "heic":
base64Str = "data:image/heic;base64," + base64Str
case "heif":
base64Str = "data:image/heif;base64," + base64Str
case "doc":
base64Str = "data:application/msword;base64," + base64Str
case "docx":
base64Str = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," + base64Str
case "ppt":
base64Str = "data:application/vnd.ms-powerpoint;base64," + base64Str
case "pptx":
base64Str = "data:application/vnd.openxmlformats-officedocument.presentationml.presentation;base64," + base64Str
case "pdf":
base64Str = "data:application/pdf;base64," + base64Str
case "txt":
base64Str = "data:text/plain;base64," + base64Str
case "xls":
base64Str = "data:application/vnd.ms-excel;base64," + base64Str
case "xlsx":
base64Str = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," + base64Str
// 常见音频格式
case "mp3", "mpeg":
base64Str = "data:audio/mpeg;base64," + base64Str
case "wav":
base64Str = "data:audio/wav;base64," + base64Str
// 常见视频格式
case "mp4":
base64Str = "data:video/mp4;base64," + base64Str
case "avi":
base64Str = "data:video/x-msvideo;base64," + base64Str
}
if len(base64Str) > 50 {
fmt.Printf("Headfile: %v\n", strings.Split(base64Str[:50], "base64,")[0])
}
return base64Str, nil
}
type DcInfo struct {
ftype string
Dtype llmshield.ContentTypeV2
}
<?php
// 引入 vendor 自动加载文件（用于 GuzzleHttp 等依赖）
require __DIR__ . "/vendor/autoload.php";
use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;
// 文档Base64编码
function load_file_content($ftype, $filePath) {
if (!file_exists($filePath) || !is_readable($filePath)) {
trigger_error("文件不存在或无法读取：{$filePath}", E_USER_ERROR);
return false;
}
$fileHandle = fopen($filePath, 'rb'); // rb = 只读 + 二进制模式（必须！）
if (!$fileHandle) {
trigger_error("无法打开文件：{$filePath}", E_USER_ERROR);
return false;
}
$binaryContent = fread($fileHandle, filesize($filePath));
fclose($fileHandle); // 务必关闭文件句柄
$base64Content = base64_encode($binaryContent);
switch ($ftype) {
case "txt":
$base64Content = "data:text/plain;base64," . $base64Content;
break;
case "doc":
$base64Content = "data:application/msword;base64," . $base64Content;
break;
case "docx":
$base64Content = "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64," . $base64Content;
break;
case "xls":
$base64Content = "data:application/vnd.ms-excel;base64," . $base64Content;
break;
case "xlsx":
$base64Content = "data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64," . $base64Content;
break;
case "pdf":
$base64Content = "data:application/pdf;base64," . $base64Content;
break;
}
return $base64Content;
}
// 图片Base64编码
function load_image_content($image_file) {
if (!file_exists($image_file)) {
throw new Exception("图片文件不存在: $image_file");
}
$image_data = file_get_contents($image_file);
$base64_content = base64_encode($image_data);
$size = strlen($base64_content);
return [$base64_content, $size];
}
// 配置信息
$myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; // 根据大模型应用防火墙实例所在地域替换相应的地域信息
$ak = "YOUR AK"; // 火山账号的 AK
$sk = "YOUR SK"; // 火山账号的 SK
$appid = "app-d2pgblcjslsilv******"; // 资产的 AppId，可在控制台资产管理页面获取
$region = "cn-beijing"; // 大模型应用防火墙实例所在地域
$timeout = 60; // 超时时间（秒）
$service = "llmshield"; // 服务名称
// 初始化客户端
$client = new LLMShieldApi($myUrl, $ak, $sk, $appid, $region, $timeout, $service, "http://10.37.**.**:8888"); // 其中 "http://10.37.**.**:8888" 为代理地址示例值
$request = new Model\ModerateV2Request();
$request->Scene = $appid;
$request->Message = new Model\MessageV2();
$request->Message->Role = "user"; // 检测的内容来源，user-用户提示词；assistant-模型响应内容
// 多模态混合检测文本
$part_content = new Model\MultiPart();
$part_content->Content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."; // 示例文本
$part_content->ContentType = Model\ContentTypeV2::TEXT;
// 多模态混合检测图片
$part_image = new Model\MultiPart();
list($image_base64, $image_size) = load_image_content("/Users/example/imagedemo.png"); // 待检测的图片本地存储路径
$part_image->Content = $image_base64;
$part_image->ContentType = Model\ContentTypeV2::IMAGE;
// 多模态混合检测文档
$part_file = new Model\MultiPart();
$part_file->Content = load_file_content("docx", "/Users/example/filedemo.docx"); // 待检测的文档格式与本地存储路径
$part_file->ContentType = Model\ContentTypeV2::FILE;
echo $part_file->Content . "\n";
$request->Message->MultiPart = [$part_content, $part_image, $part_file];
$client->Moderate($request)->then(function ($resp) {
echo json_encode($resp[0], JSON_UNESCAPED_UNICODE) . "\n";
echo $resp[1] . "\n";
echo json_encode($resp[2], JSON_UNESCAPED_UNICODE) . "\n";
})->wait();
最近更新时间：2026.04.27 19:47:53
这个页面对您有帮助吗？
有用
有用
无用
无用