【AI】【内容安全防护】----调用私有化部署 Qwen3Guard-Stream 内容防护：核心配置+参数全解

Java 高级调用私有化部署 Qwen3Guard-Stream 内容防护核心配置参数全解Qwen3Guard-Stream 是阿里云通义千问开源的流式内容安全检测模型私有化部署后Java 调用核心需要掌握部署配置、接口参数、鉴权/通信配置、流式调用参数四大类信息我直接给你开箱即用的完整清单包含私有化场景必须的所有配置和参数。一、先明确私有化 Qwen3Guard-Stream 核心形态私有化部署的 Qwen3Guard-Stream 本质是HTTP 服务支持标准 POST SSE 流式响应Java 调用就是发起 HTTP 请求 解析 SSE 流无需依赖官方 SDK纯原生/通用 HTTP 客户端即可调用。二、必须知道的【部署基础配置】私有化必填这是 Java 调用的根配置没有这些无法连接服务配置项含义示例备注服务地址 (Base URL)私有化部署的 Qwen3Guard 服务根地址http://192.168.1.100:8000内网/私有网络地址无公网访问接口路径内容检测接口固定路径/v1/guard官方标准路径私有化一般不修改端口服务监听端口8000 / 8080 / 9000部署时自定义防火墙必须放行协议通信协议http / https私有化默认 httphttps 需额外配置证书模型版本Qwen3Guard 模型版本qwen3-guard-7b / qwen3-guard-1.8b决定检测能力请求无需传参但需匹配部署部署模式单机/集群单机调用无区别负载均衡配置地址即可Java 拼接最终调用地址// 完整检测地址 基础地址 接口路径StringguardUrlhttp://192.168.1.100:8000/v1/guard;三、【请求头参数】Java 调用必须携带Qwen3Guard-Stream 是标准大模型流式接口请求头固定如下1. 必选请求头Header 键值作用Content-Typeapplication/json声明请求体为 JSON 格式Accepttext/event-stream核心声明接收 SSE 流式响应Cache-Controlno-cache禁用缓存保证实时流Connectionkeep-alive保持长连接适配流式传输Java 代码示例设置请求头// HttpURLConnection / OkHttp 通用头配置HttpHeadersheadersnewHttpHeaders();headers.setContentType(MediaType.APPLICATION_JSON);headers.set(Accept,text/event-stream);headers.set(Cache-Control,no-cache);headers.set(Connection,keep-alive);四、【请求体核心参数】检测内容的关键这是内容防护的核心参数决定检测什么、怎么检测私有化和官方开源版完全一致。完整请求体 JSON 结构{input:需要检测的文本内容,stream:true,tasks:[text_moderation],parameters:{moderation_level:strict,return_details:true}}逐字段详解Java 封装对象必用参数名类型必填可选值/说明inputString✅ 是待检测的用户输入/对话内容streamboolean✅ 是true流式返回Qwen3Guard-Streamfalse一次性返回tasksArray[String]✅ 是固定值[text_moderation]文本安全检测parametersObject否检测策略配置高级控制↳ moderation_levelString否检测严格度loose宽松/moderate标准/strict严格默认moderate↳ return_detailsboolean否是否返回详细违规类型true返回分类理由false仅返回通过/违规简化版最小可用请求体{input:这是需要检测的文本,stream:true,tasks:[text_moderation]}五、【流式响应 SSE 格式】Java 解析必须匹配Qwen3Guard-Stream 采用SSE(Server-Sent Events)流式返回每一条消息以data:开头Java 必须按此格式解析。1. 响应数据结构data: {id:xxx,model:qwen3-guard,choices:[{delta:{content:{...检测结果}},finish_reason:null}]} data: [DONE] // 流结束标志2. 检测结果核心字段content 内字段含义is_safetrue安全 /false违规categories违规类型数组涉政/色情/暴力/辱骂等confidence置信度 0~1message检测说明六、【私有化专属高级配置】生产环境必须1. 网络与访问控制内网白名单Java 服务所在服务器 IP 必须加入 Qwen3Guard 部署机白名单无公网访问私有化部署默认无鉴权无需 AK/SK纯内网通信超时配置流式请求超时建议 ≥30s避免模型推理超时2. 模型性能配置对接部署方确认配置Java 调用影响并发数单实例最大并发 QPS超过会拒绝请求推理精度fp16 / int8不影响调用参数最长文本长度输入input最大字符数默认 8192七、Java 调用完整代码示例开箱即用基于Spring WebClient SSE 流式解析最适合 Java 后端调用1. 依赖MavendependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-webflux/artifactId/dependency2. 核心调用代码importorg.springframework.http.MediaType;importorg.springframework.web.reactive.function.BodyInserters;importorg.springframework.web.reactive.function.client.WebClient;importreactor.core.publisher.Flux;publicclassQwen3GuardStreamClient{// 私有化部署地址privatestaticfinalStringGUARD_URLhttp://192.168.1.100:8000/v1/guard;publicFluxStringcheckTextStream(StringinputText){// 构建请求体GuardRequestrequestnewGuardRequest();request.setInput(inputText);request.setStream(true);request.setTasks(newString[]{text_moderation});// 流式调用returnWebClient.create().post().uri(GUARD_URL).contentType(MediaType.APPLICATION_JSON).header(Accept,text/event-stream).body(BodyInserters.fromValue(request)).retrieve().bodyToFlux(String.class)// 接收 SSE 流.filter(line-!line.isEmpty());}// 请求体实体类staticclassGuardRequest{privateStringinput;privatebooleanstream;privateString[]tasks;// getter/setter}}八、你必须向部署方确认的【最终清单】服务内网地址 端口接口路径默认/v1/guard最大输入文本长度支持的并发 QPS是否开启 https如需则要证书模型版本1.8b/7b总结核心调用方式Java 发送 POST 请求 SSE 流式接收纯 HTTP 无特殊依赖必填参数input(检测文本)、streamtrue、tasks[text_moderation]私有化关键内网地址、端口、网络白名单无鉴权参数响应格式SSE 流以data:开头[DONE]结束