文档中心

大模型应用防火墙

SDK 参考

SDK 概览

大模型应用防火墙 SDK 是面向大语言模型应用的内容安全与合规治理组件，提供从输入提示词到模型响应的全链路合规检测与安全代答能力。你可以通过该 SDK 将业务资产（以 AppID 识别）与防护策略绑定，按地域接入服务地址（myUrl/region），并以非流式或流式方式完成内容检测与优化结果生成。

SDK 简介

大模型应用防火墙 SDK 封装了最新版本的 API，以访问密钥（AccessKey）识别调用者身份，提供自动签名等功能，方便您通过 API 创建和管理资源。

同时支持配置代理服务，如果你的大模型业务使用代理服务器转发客户端数据（如用户输入内容）、接收并回传服务端数据（如模型响应结果），可在 SDK 初始化时配置代理相关参数以满足业务所需。

核心功能

文本内容合规检测（非流式）：一次性提交完整上下文进行深度语义分析，适用于需要整体语义的场景；通过 Moderate 接口返回检测结果与决策类型（如“放行”“拦截”等）。

文本内容合规检测（流式）：在模型流式响应期间分块送检，降低整体等待时间；通过 UseStream = 1 或 UseStream = 2控制会话生命周期，支持边生成边检测的场景。

安全代答生成：当检测结果需要“安全代答”时，基于 MsgID 触发 Generate 接口获取安全且友好的代答，结果以流式段落返回，适配需要自动修正输出的使用场景。

注意

使用流式检测时，需要待检测完全结束（最后一次传入 UseStream=2）并返回结果后，才能调用代答接口，否则可能会导致调用失败。

版本兼容说明

以下为大模型应用防火墙不同 SDK 版本支持的功能特性，在调用 SDK 前，请确保使用的 SDK 版本与需求功能相匹配。

更新内容	语言	SDK 版本和 GitHub 地址
支持通过一次 SDK 调用完成内容检测并获取安全代答内容支持七层反向代理	Python	V5.0.48 及之后版本
		Java	V2.0.26 及之后版本
		Go	V1.2.51 及之后版本
支持机密模型检测	Python	V5.0.34 及之后版本
		Java	V2.0.18 及之后版本
		Go	V1.2.35 及之后版本
支持幻觉检测支持多轮对话检测支持自定义超时时间	Python	V5.0.29 及之后版本
		Java	V2.0.7 及之后版本
		Go	V1.2.30 及之后版本
		PHP	V1.0.114 及之后版本
支持检测代理服务数据和文档内容支持多模态混合检测，即同时检测文本、图片、文档、音频和视频内容	Python	V4.0.39 及之后版本
		Java	V1.0.8 及之后版本
		Go	V1.1.52 及之后版本
		PHP	V1.0.89 及之后版本
适配新版控制台功能支持检测文本内容和图片内容	Python	V4.0.17 及之后版本
		Java	V0.2.31 及之后版本
		Go	V1.1.32 及之后版本
		PHP	V1.0.84 及之后版本