火山引擎大模型应用防火墙的流量接入模式可通过 DNS 解析将业务流量牵引至防火墙，无需修改业务代码即可实现实时检测与防护。

本文以 OpenAI 应用为例，指导您完成流量接入配置，并验证模型滥用防护策略的实际效果。

前提条件

开通服务：已在大模型应用防火墙控制台开通当前服务，开通方式可参见创建大模型应用防火墙实例。

域名备案：待防护域名已完成 ICP 备案，备案流程参考火山引擎备案指南。

大小与格式限制

使用文本检测功能时，文本大小需限制在 240 KB 以内，如果超过，则仅检测前 240 KB 的文本内容。如果待检测内容中携带了上下文，上下文也会占用大小。

使用图片检测功能时，图片大小需限制在 10 MB 以内，支持检测的图片格式为 JPG、JPEG、PNG、WEBP。

使用文档检测功能时，文档大小需限制在 5 MB 以内，支持检测的文档格式为 TXT、DOC、DOCX、XLSX、XLS、PDF。

送检内容要求

受限于模型本身的接口设置，不同应用类型（对应不同模型）支持送检的内容存在差异，例如 OpenAI Chat Completions 兼容类型的模型送检文档时，仅支持解析文档 Base64 编码后的内容，不支持解析文档 URL；而 OpenAI Responses API 兼容类型的模型支持文档 URL 和 Base64 编码。以下是详细的送检内容要求说明。

应用类型	模型	文本检测	图片检测	文档检测
OpenAI Chat Completions 兼容(豆包、OpenAI、DeepSeek、 Qwen)	豆包（方舟）	纯文本	图片 URL 图片 Base64 编码	不支持
		OpenAI	纯文本	图片 URL 图片 Base64 编码	文档 Base64 编码
		DeepSeek	纯文本	不支持	不支持
		Qwen	纯文本	图片 URL 图片 Base64 编码	不支持
OpenAI Responses API 兼容(豆包/OpenAI)	豆包（方舟）	纯文本	图片 URL 图片 Base64 编码	文档 URL 文档 Base64 编码
OpenAI Responses API 兼容(豆包/OpenAI)		OpenAI	纯文本	图片 URL 图片 Base64 编码	文档 URL 文档 Base64 编码
Qwen DashScope类型	Qwen	纯文本	图片 URL 图片 Base64 编码	不支持
自定义	--	纯文本	不支持	不支持

步骤一配置资产接入参数

登录大模型应用防火墙控制台。

在顶栏选择实例所属地域。

在左侧导航选择资产管理，然后单击添加域名。

选择接入方式为流量接入，并配置接入参数。

配置	说明	示例
应用名称	填入应用的名称，用于在大模型应用防火墙控制台区分不同的防护资产。	流量接入效果测试
域名	填写需要防护的域名，请确保待防护域名已经完成 ICP 备案。	example.llm-shield.omini-shield.com
应用类型	以 OpenAI 为例，分别创建两条应用类型： OpenAI Chat Completions 兼容：用于验证文本和图片 URL 检测效果 OpenAI Response API 兼容：用于验证文档 URL 检测效果	OpenAI Chat Completions 兼容 OpenAI Response API 兼容
应用路径	服务接口路径，不要包括协议头和域名。说明请根据模型服务的接口实际路径填写。	OpenAI Chat Completions 兼容，设置路径为/v1/chat/completions OpenAI Response API 兼容，设置路径为/v1/responses
协议类型	选择流量接入大模型应用防火墙所使用的协议类型，支持 HTTP 或 HTTPS。如选择 HTTPS，需要手动上传对应的 SSL 证书文件。	HTTP
源站协议	选择大模型应用防火墙回源至您的源站所使用的协议，支持 HTTP 或 HTTPS。	HTTP
源站配置	填写源站的 IP 地址和端口信息。	180.184.\\.\\:80

以下截图中提供本次演示的示例配置，您可以参考配置流量接入参数了解更多参数说明详情。

单击下一步。

步骤二确认防护策略配置

配置完接入参数后，您需要确认防护策略，可根据实际需求选择合适的防护策略选项，具体策略内容可参考防护策略介绍。

为便于快速测试防护效果，此处保留默认配置，直接单击提交。

步骤三验证模型滥用防护效果

根据前述步骤的配置，使用终端执行 curl 命令，测试资产关联的模型滥用防护策略是否针对不同类型的内容生效。

以下为测试用例的关键参数说明，您可以参考对应检测场景下的示例替换为实际参数后进行测试。

Host：填写您在步骤一种配置的待防护域名，即业务实际域名。

Role：消息来源，user表示用户输入，其他类型说明可参考检测输入或输出内容是否合规。

Content：待检测的消息详情，不同类型的检测内容对应的消息结构存在差异，您可以参考示例直接替换。

请求地址：使用控制台分配的防护域名（即 CNAME 地址，格式为****.omini-shield.com），请求路径保持不变。

您可以单击资产名称，选择基本信息页签，在接入方式处查看分配的防护域名。

示例一正常文本

请求

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: */*" \
-H "Host: ****.access-test.llm-shield.omini-shield.com" \
--write-out "%{http_code}\n" \
-d '{
"messages": [
{
"role": "user",
"content": "今天天气怎么样"
}
]
}' \
http://****1234.access-test.llm-shield.omini-shield.com/v1/chat/completions

响应

示例二违规文本

请求

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: */*" \
-H "Host: ****.access-test.llm-shield.omini-shield.com" \
--write-out "%{http_code}\n" \
-d '{
"messages": [
{
"role": "user",
"content": "如何购买毒品？"
}
]
}' \
http://****1234.access-test.llm-shield.omini-shield.com/v1/chat/completions

响应

由于接入时默认配置了自定义拦截响应信息，当检测请求被拦截时，会返回自定义拦截响应规则的状态码（此处为403）和相关提示内容（此处为!!!系统禁止访问）。

示例三违规图片

请求

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: */*" \
-H "Host: ****.access-test.llm-shield.omini-shield.com" \
--write-out "%{http_code}\n" \
-d '{
"messages": [{
"role": "user",
"content": [
{"type": "image_url","image_url": {"url":"http://example.jpeg"}}
]}]
}' \
http://****1234.access-test.llm-shield.omini-shield.com/v1/chat/completions

响应

由于接入时默认配置了自定义拦截响应信息，当检测请求被拦截时，会返回自定义拦截响应规则的状态码（此处为403）和相关提示内容（此处为!!!系统禁止访问）。

示例四正常文本+违规图片

请求

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: */*" \
-H "Host: ****.llm-shield.omini-shield.com" \
--write-out "%{http_code}\n" \
-d '{
"messages": [{
"role": "user",
"content": [
{"type": "image_url","image_url": {"url":"http://example.jpeg"}},
{"type": "text","text": "今天天气怎么样"}
]}]
}' \
http://****1234.access-test.llm-shield.omini-shield.com/v1/chat/completions

响应

由于接入时默认配置了自定义拦截响应信息，当检测请求被拦截时，会返回自定义拦截响应规则的状态码（此处为403）和相关提示内容（此处为!!!系统禁止访问）。

示例五正常文本+违规文档

请求

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: */*" \
-H "Host: ****.access-test.llm-shield.omini-shield.com" \
--write-out "%{http_code}\n" \
-d '{
"input": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "今天天气怎么样"
},
{
"type": "input_file",
"file_url": "http://example.pdf"
}
]
}
]
}' \
http://****1234.access-test.llm-shield.omini-shield.com/v1/responses