大模型应用防火墙
大模型应用防火墙
- 文档首页
大模型应用防火墙SDK 参考图片检测
复制全文
下载 pdf图片检测
文档反馈
问问助手您可以基于大模型应用防火墙 SDK 调用接口对图片内容进行检测。本文提供 Python、Java、Go、PHP 开发语言的图片内容检测示例代码，供您参考。
注意事项
- 前置依赖：参考SDK 安装和初始化完成依赖安装和初始化配置。
- 接口说明：接口介绍、使用限制以及参数描述，请参见检测输入或输出内容是否合规。
- 版本要求：
- 语言版本pythonJavaGoPHP
无代理服务
Python
Java
Go
PHP
from volcenginesdkllmshield import *
import 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 # 超时时间（秒）
image_file = "/Users/Downloads/192750.jpeg" # 待检测图片的本地存储路径
image_content, size = load_image_content(image_file)
# 确保图片大小不超过 10 MB
if size > 1010241024:
print(f"请求失败: {size/1024}KB")
return
try:
# 发送请求并获取响应
client = ClientV2(myUrl, ak, sk, region, TIMEOUT)
# 构建请求（使用 pydantic 模型）
request = ModerateV2Request(
scene=appid, # 资产的 AppId
message=MessageV2(
role="user", # 检测的内容来源，user-用户提示词；assistant-模型响应内容
content=image_content, # 需要检测的图片内容
content_type=ContentTypeV2.IMAGE
),
# history=[
# MessageV2(
# role="system", # 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
# content="你是一个智能助手",
# content_type=ContentTypeV2.TEXT
# ),
# MessageV2(
# role="assistant", # 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
# content="Day 1：抵达昆明・滇池与石林初探...",
# content_type=ContentTypeV2.TEXT
# )
# ]
)
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.TestLLMshieldV2;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Base64;
import com.volcengine.llmshield.*;
public class ModerateBoe {
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 image_content = "";
String image_file = "/Users/Downloads/192750.jpeg"; // 待检测图片的本地存储路径
try {
image_content = convertImageToBase64(image_file);
int flen =image_file.length();
// 确保图片大小不超过 10 MB
if (flen > 10 * 1024 * 1024) {
System.out.println("Content size bigger than system：" + flen/1024 + "KB");
return;
}
} catch (IOException e) {
System.err.println("转换失败:" + e.getMessage());
e.printStackTrace();
}
System.out.println("Content is:" + image_content);
// 设置检测内容
MessageV2 message = new MessageV2();
message.setContent(image_content);
message.setRole("user"); // 检测的内容来源，user-用户提示词；assistant-模型响应内容
message.setContentType(ContentTypeV2.IMAGE);
request.setMessage(message);
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"
"time"
"github.com/volcengine/volcengine-go-sdk/service/llmshield"
)
func EncodeImageToBase64(imagePath string) (string, error) {
// 读取图片文件内容
data, err := os.ReadFile(imagePath)
if err != nil {
return "", fmt.Errorf("读取图片失败: %v", err)
}
// 进行Base64编码
base64Str := base64.StdEncoding.EncodeToString(data)
return base64Str, nil
}
func main() {
var response *llmshield.ModerateV2Response
var err error
myUrl := "https://cn-beijing.sdk.access-test.llm-shield.omini-shield.com" // 根据大模型应用防火墙实例所在地域替换相应的地域信息
ak := "YOUR AK" // 火山账号的 AK
sk := "YOUR SK" // 火山账号的 SK
appid := "app-d3r06khsqn9s73da****" // 资产的 AppId，可在控制台资产管理页面获取
region := "cn-beijing" // 大模型应用防火墙实例所在地域
timeout := time.Second * 60 // 超时时间
request := llmshield.ModerateV2Request{
Message: nil,
Scene: appid,
}
dtstr, err := EncodeImageToBase64("/Users/Downloads/192750.jpeg") // 待检测图片的本地存储路径
dsize := len(dtstr)
// 确保图片大小不超过 10 MB
if err != nil || dsize > 1010241024 {
fmt.Printf("%v,dsize:%v", err, dsize)
return
}
request.Message = &llmshield.MessageV2{
Content: dtstr,
ContentType: llmshield.ContentTypeV2_IMAGE,
Role: "user",
}
// 创建客户端实例
client := llmshield.New(myUrl, ak, sk, region, timeout)
if client == nil {
fmt.Printf("Failed to create client instance\n")
return
}
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())
}
<?php
require __DIR__ . "/vendor/autoload.php";
use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;
/**
* 加载图片内容并返回Base64编码和大小
* @param string $image_file 图片文件路径
* @return array [Base64编码的图片内容, 大小]
* @throws Exception 当图片文件不存在或无法读取时抛出异常
*/
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"; // 服务名称
// 待检测图片的本地存储路径
$image_file = "/Users/Test/大模型应用防火墙/20251105-211228.jpeg"; // 请替换为您的图片本地存储路径
// 尝试加载图片
$image_content = null;
try {
// 加载图片内容并获取大小
list($image_content, $size) = load_image_content($image_file);
// 确保图片大小不超过 10 MB
if ($size > 1010241024) {
echo "请求失败: " . ($size/1024) . "KB\n";
exit(1);
}
echo "成功加载图片: $image_file, 大小: " . ($size/1024) . "KB\n";
} catch (Exception $e) {
echo "错误: " . $e->getMessage() . "\n";
exit(1);
}
// 初始化客户端
$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-模型响应
$request->Message->Content = $image_content; // Base64编码的图片内容
$request->Message->ContentType = Model\ContentTypeV2::IMAGE; // 设置为图片类型
// 图片检测通常不需要上下文，设置为空数组
$request->History = [];
$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
from volcenginesdkllmshield import *
import 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"}
image_file = "/Users/Downloads/192750.jpeg" # 待检测图片的本地存储路径
image_content, size = load_image_content(image_file)
# 确保图片大小不超过 10 MB
if size > 1010241024:
print(f"请求失败: {size/1024}KB")
return
try:
# 发送请求并获取响应
client = ClientV2(myUrl, ak, sk, region, TIMEOUT)
# 设置代理地址
client.SetProxy(proxy_dict)
# 设置最大连接数，例如 100
client.SetConnMax(100)
# 构建请求（使用 pydantic 模型）
request = ModerateV2Request(
scene=appid, # 资产的 AppId
message=MessageV2(
role="user", # 检测的内容来源，user-用户提示词；assistant-模型响应内容
content=image_content, # 需要检测的图片内容
content_type=ContentTypeV2.IMAGE
),
# history=[
# MessageV2(
# role="system", # 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
# content="你是一个智能助手",
# content_type=ContentTypeV2.TEXT
# ),
# MessageV2(
# role="assistant", # 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
# content="Day 1：抵达昆明・滇池与石林初探...",
# content_type=ContentTypeV2.TEXT
# )
# ]
)
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.TestLLMshieldV2;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Base64;
import com.volcengine.llmshield.*;
public class ModerateBoe {
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 image_content = "";
String image_file = "/Users/Downloads/192750.jpeg"; // 待检测图片的本地存储路径
try {
image_content = convertImageToBase64(image_file);
int flen =image_file.length();
// 确保图片大小不超过 10 MB
if (flen > 10 * 1024 * 1024) {
System.out.println("Content size bigger than system：" + flen/1024 + "KB");
return;
}
} catch (IOException e) {
System.err.println("转换失败:" + e.getMessage());
e.printStackTrace();
}
System.out.println("Content is:" + image_content);
// 设置检测内容
MessageV2 message = new MessageV2();
message.setContent(image_content);
message.setRole("user"); // 检测的内容来源，user-用户提示词；assistant-模型响应内容
message.setContentType(ContentTypeV2.IMAGE);
request.setMessage(message);
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"
"time"
"github.com/volcengine/volcengine-go-sdk/service/llmshield"
)
func EncodeImageToBase64(imagePath string) (string, error) {
// 读取图片文件内容
data, err := os.ReadFile(imagePath)
if err != nil {
return "", fmt.Errorf("读取图片失败: %v", err)
}
// 进行Base64编码
base64Str := base64.StdEncoding.EncodeToString(data)
return base64Str, nil
}
func main() {
var response *llmshield.ModerateV2Response
var err error
myUrl := "https://cn-beijing.sdk.access-test.llm-shield.omini-shield.com" // 根据大模型应用防火墙实例所在地域替换相应的地域信息
ak := "YOUR AK" // 火山账号的 AK
sk := "YOUR SK" // 火山账号的 SK
appid := "app-d3r06khsqn9s73da****" // 资产的 AppId，可在控制台资产管理页面获取
region := "cn-beijing" // 大模型应用防火墙实例所在地域
timeout := time.Second * 60 // 超时时间
request := llmshield.ModerateV2Request{
Message: nil,
Scene: appid,
}
dtstr, err := EncodeImageToBase64("/Users/Downloads/192750.jpeg") // 待检测图片的本地存储路径
dsize := len(dtstr)
// 确保图片大小不超过 10 MB
if err != nil || dsize > 1010241024 {
fmt.Printf("%v,dsize:%v", err, dsize)
return
}
request.Message = &llmshield.MessageV2{
Content: dtstr,
ContentType: llmshield.ContentTypeV2_IMAGE,
Role: "user",
}
// 创建客户端实例
client := llmshield.NewAdvanced(myUrl, ak, sk, region, timeout, "http://10.37.**.**:8888", 30) // 其中 "http://10.37.**.**:8888" 为代理地址示例值、30 为最大连接数示例值
if client == nil {
fmt.Printf("Failed to create client instance\n")
return
}
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())
}
<?php
require __DIR__ . "/vendor/autoload.php";
use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;
/**
* 加载图片内容并返回Base64编码和大小
* @param string $image_file 图片文件路径
* @return array [Base64编码的图片内容, 大小]
* @throws Exception 当图片文件不存在或无法读取时抛出异常
*/
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"; // 服务名称
// 待检测图片的本地存储路径
$image_file = "/Users/Test/大模型应用防火墙/20251105-211228.jpeg";
// 尝试加载图片
$image_content = null;
try {
// 加载图片内容并获取大小
list($image_content, $size) = load_image_content($image_file);
// 确保图片大小不超过 10 MB
if ($size > 10*1024*1024) {
echo "请求失败: " . ($size/1024) . "KB\n";
exit(1);
}
echo "成功加载图片: $image_file, 大小: " . ($size/1024) . "KB\n";
} catch (Exception $e) {
echo "错误: " . $e->getMessage() . "\n";
exit(1);
}
// 初始化客户端
$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-模型响应
$request->Message->Content = $image_content; // Base64编码的图片内容
$request->Message->ContentType = Model\ContentTypeV2::IMAGE; // 设置为图片类型
// 图片检测通常不需要上下文，设置为空数组
$request->History = [];
$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
这个页面对您有帮助吗？
有用
有用
无用
无用