功能概述
SDK/API 接入是 Web 应用防火墙（WAF）大模型安全模块提供的一种轻量化接入方式。通过 SDK/API 接入，可以在不将业务域名迁移到 WAF 的前提下，直接调用 WAF 的大模型内容安全检测能力，对大模型的输入和输出内容进行安全审核。
操作场景
本文介绍如何通过 SDK/API 方式将大模型业务接入 WAF 大模型安全模块。适用于以下场景：
大模型业务不希望将域名全部迁移到 WAF，但需要使用 WAF 的内容安全检测能力。
希望以较小的业务改动成本，快速集成大模型内容安全审核功能。
业务架构不适合通过域名接入方式串接 WAF 流量。
说明：
前提条件
已获取腾讯云 API 访问密钥（SecretId 和 SecretKey）。如未获取，请前往 API 密钥管理 页面创建。
注意：
密钥对应的用户需要拥有
QcloudWAFFullAccess 权限。请妥善保管安全凭证，避免泄露，否则将危及财产安全。如已泄露，请立刻禁用该安全凭证。操作步骤
步骤一：添加 SDK 接入应用
1. 登录 WAF 控制台，在左侧导航栏中，单击大模型安全。
2. 在大模型安全页面，单击 SDK 接入。
3. 在 SDK 接入页面①添加应用中，填写应用名称等信息，单击添加应用。
4. 添加成功后，系统将返回该应用的 Service ID。
说明：
Service ID 为系统自动生成的唯一标识，用于 API 调用时指定防护策略。请妥善记录，后续调用 API 时需要使用。
步骤二：配置防护策略
添加应用后，需要为该应用配置大模型安全防护策略，包括算力消耗防护和内容安全防护。
1. 在 SDK 接入列表页，找到目标应用，单击防护配置。
2. 根据业务需求，配置算力消耗防护规则和内容安全防护规则。
说明：
步骤三：安装并接入 SDK
完成控制台配置后，需要在业务代码中集成 WAF SDK，调用内容安全检测接口。
选择接入地域
当前支持以下地域接入，推荐使用就近地域接入域名以降低时延：
接入地域 | 域名 |
就近地域接入（推荐，仅支持非金融区） | waf.tencentcloudapi.com |
华南地区（广州） | waf.ap-guangzhou.tencentcloudapi.com |
华东地区（上海） | waf.ap-shanghai.tencentcloudapi.com |
华东地区（南京） | waf.ap-nanjing.tencentcloudapi.com |
华北地区（北京） | waf.ap-beijing.tencentcloudapi.com |
西南地区（成都） | waf.ap-chengdu.tencentcloudapi.com |
西南地区（重庆） | waf.ap-chongqing.tencentcloudapi.com |
说明：
推荐使用就近地域接入域名，系统会根据调用方所在位置自动解析到最近的服务器。例如在广州发起请求，效果与指定
waf.ap-guangzhou.tencentcloudapi.com 一致。对时延敏感的业务，建议指定带地域的域名。
域名是 API 的接入点，并不代表产品或接口实际提供服务的地域。
安装 SDK
调用接口
大模型安全 SDK/API 接入共提供 2 个核心接口：
接口名 | 接口描述 | 典型用途 |
大模型内容审核接口 | 对用户输入或模型输出的文本/图片内容进行内容安全风险检测 基于已配置的防护规则，检测提示词注入、内容安全、敏感数据等风险，返回检测结果及风险分类标签 | |
大模型安全代答生成接口 | 当内容审核接口检测到风险时，调用本接口由大模型实时生成替代回答 支持流式 SSE 返回，基于风险分类和对话上下文实时生成 |
您可以调用
DescribeLLMContentSecCheck 接口创建内容检测任务，对用户输入或模型输出进行内容安全审核。如果您需要获取模型代答内容以响应用户，需要先获取内容检测接口返回的检测消息 ID（MsgID），再调用
GenerateLLMSecAnswer 接口获取代答结果。接口将以流式方式返回响应内容，基于风险分类和对话上下文实时生成替代回答。可前往 API Explorer 对接口进行在线调试，详情请参见 使用 API Explorer。
步骤四：结果验证
1. 使用测试用例（含正常内容与预期命中风险的内容）调用 SDK/API 接口。
2. 登录 WAF 控制台，在大模型安全页面查看是否有对应的检测记录和日志。
3. 验证通过后，即表示 SDK/API 接入成功，WAF 将按照配置的防护策略对大模型内容进行安全检测。
