输入内容分析接口

更新时间：2025-07-29

接口描述

大模型内容安全场景中，该接口用于检测用户输入prompt内容安全性，并针对高风险内容返回拒答提示，针对中低风险内容提供安全代答服务。

权限说明

该接口的访问权限需要进行鉴权，仅允许授权用户或客户端调用。鉴权方式为使用密钥aksk和签名sign进行验证，可在服务开通后获取。

在开通服务后，接口鉴权按照百度智能云鉴权方式，或者参考服务端sdk，注册百度智能云ak/sk，即可使用。

接口说明

服务地址

https://afd.bj.baidubce.com

接口协议

接口遵守restful风格，基于HTTP协议，UTF-8编码

请求和响应数据格式：JSON

接口路径

接口	URI	METHOD	描述
输入内容分析接口	/rcs/llm/input/analyze	POST	分析用户提问内容是否安全，并提供风险检测和代答能力

请求参数

参数名	类型	是否必填	描述
query	string	是	检测内容，建议最长不超过512字符，内容过长可分次请求
historyQA	List<Map<String,String>>	否	历史对话信息，列表中为按先后顺序的排列QA信息，每个map为一次QA信息，其中轮次不限制，QA对文本总长度小于2048，超过时，舍弃历史最久远的QA对，如：[ { "Q": "打卤面好吃吗？", "A": "打卤面是一种中国北方的传统美食，其口味和口感各不相同，但通常情况下，打卤面是十分好吃的。\n首先，打卤面的面条非常讲究，使用优质面粉和机器压成的切面，使得面条口感更加嫩滑、有面筋、有嚼劲。这样的面条与" }, { "Q": "它是怎么做的？", "A": "使用机器和面，然后切成面条" }]
appid	string	否	应用ID：标识查询方，通过智能云控制台创建
stream	boolean	否	流式请求：true 非流式请求：false此参数若为空，则为false
templateId	string	否	模板ID：管理控制台配置的策略模板的编码ID，用于生效不同的策略模板，不传则使用默认的标准策略模版
userId	string	否	用户ID：用户唯一标识

响应参数-非流式返回

参数名	类型	是否必填	描述
request_id	string	是	请求id
ret_code	string	是	返回状态码，0表示成功，非0表示失败。
ret_msg	string	是	返回信息，包括错误信息和警告信息等。
ret_data	Map<String,Object>	是	返回结果，包括检测结果和处理结果等。

响应参数-流式返回

	参数名	类型	是否必填	描述
data	request_id	string	是	请求id
	code	int	是	返回状态码，0表示成功，非0表示失败。
	msg	string	是	返回信息，包括错误信息和警告信息等。
	data	Map<String,Object>	是	返回结果，包括检测结果和处理结果等。

data详细内容

参数名	类型	二级字段	描述
isSafe	int		文本是否安全，0: 风险 1: 安全
action	int		安全措施，0：正常，1：红线必答， 2：安全大模型， 3：兜底回复， 6：不上屏
hitType	string		一级风险分类，action为0、2、3、4、5、6时返回，点击下载
subHitType	int		二级风险分类，文档同上
langType	string		zh：中文、 en：英文、 minor_lang：小语种
score	float		安全算子得分，action为0、2、3、4、5、6时返回
hitWord	string		命中关键词，只有命中词库时返回
redline	Map<String，String>		红线必答，action为1时返回
		socre: float 相似度得分
		answer: string 红线必答回答
safeChat	string		安全大模型回答内容，action为2时返回
		data:string	【流式】代答返回的内容
		end:bool	【流式】是否为最后一段
		reasoningContent	【流式】【深度思考】深度思考内容
		content	【流式】【深度思考】回答内容
defaultAnswer	string		兜底回复内容，action为3时返回

请求示例

                JSON
                
                curl -w %{time_total}  -X POST  "http://xx.xx.xx.xx/{uri}?鉴权信息=填这里" -H "Content-Type:application/json" -d '{"query":"今天天气怎么样","historyQA":[],"stream":true}'

响应示例

返回示例-正常

                JSON
                
            

                {
	"request_id": "cb303fef-b7f3-41ef-bf07-83a2fe06145a",
	"ret_code": "0",
	"ret_msg": "操作成功",
	"ret_data": {
		"hitType": "normal",
        "subHitType": "normal",
		"action": 0,
		"isSafe": 1
	}
}
            

返回示例-红线必答

                JSON
                
            

                {
	"request_id": "25cc3a4c-2394-4586-b907-a9e1c47b7c45",
	"ret_code": "0",
	"ret_msg": "操作成功",
	"ret_data": {
		"redline": {
			"score": 0.9887741804122925,
			"answer": "今天天气非常好。"
		},
		"action": 1,
		"isSafe": 0
	}
}
            

返回示例-安全大模型-非流式返回

                JSON
                
            

                {
    "request_id": "dab11529-4c84-4155-a309-c19d29cb7097",
    "ret_code": "0",
    "ret_msg": "操作成功",
    "ret_data": {
        "score": 0.9994530081748962,
        "hitType": "shehuang",
        "subHitType": "pornography",
        "safeChat": "作为一个人工智能语言模型，我无法提供此类信息。 这种类型的信息可能会违反法律法规，并对用户造成严重的心理和社交伤害。 建议您遵守相关的法律法规和社会道德规范，并寻找其他有益和健康的娱乐方式。\n",
        "action": 2,
        "isSafe": 0
    }
}
            

返回示例-安全大模型-流式返回

                JSON
                
                data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"今天","end":false},"action":2,"langType":"zh","isSafe":0}}

data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"天气","end":false},"action":2,"langType":"zh","isSafe":0}}

data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"非常","end":false},"action":2,"langType":"zh","isSafe":0}}

data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"好","end":false},"action":2,"langType":"zh","isSafe":0}}

data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"我的心情","end":false},"action":2,"langType":"zh","isSafe":0}}

data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"score":0.8814314603805542,"hitType":"politics","safeChat":{"data":"也好起来了\n","end":true},"action":2,"langType":"zh","isSafe":0}}

返回示例-兜底回复

                JSON
                
            

                {
	"request_id": "2434f92a-6423-4033-b46b-fa4d0658e731",
	"ret_code": "0",
	"ret_msg": "操作成功",
	"ret_data": {
		"defaultAnswer": "抱歉，作为一个人工智能语言模型，我还没有学习学会如何回答这个问题，我会继续学习，为您提供更加优质的服务。",
		"score": 0.9989891648292542,
		"hitType": "values",
        "subHitType": "mental_health",
		"action": 3,
		"isSafe": 0
	}
}
            

返回示例-不上屏

                JSON
                
            

                {
	"request_id": "89ca8152-187c-467a-9fbd-899b37b2c9b8",
	"ret_code": "0",
	"ret_msg": "操作成功",
	"ret_data": {
		"score": 0.9998698234558105,
		"hitType": "gongji_politics",
        "subHitType": "territorial_integrity_negative",
		"action": 6,
		"isSafe": 0
	}
}
            

返回示例-小语种

                JSON
                
            

                {
	"request_id": "89ca8152-187c-467a-9fbd-899b37b2c9b8",
	"ret_code": "0",
	"ret_msg": "操作成功",
	"ret_data": {
        "hitType": "normal",
        "subHitType": "normal",
        "action": 0,
        "langType": "minor_lang",
        "hitWord": "",
        "isSafe": 1
    }
}
            

业务处理流程参见下图：

接口说明

输出内容分析接口

百度智能云

大模型内容安全平台 AIGC_SEC

大模型内容安全平台 AIGC_SEC

输入内容分析接口

接口描述

权限说明

接口说明

服务地址

接口协议

接口路径

请求参数

响应参数-非流式返回

响应参数-流式返回

data详细内容

请求示例

响应示例