输入代答大模型接口
更新时间:2024-10-16
接口描述
大模型内容安全场景中,该接口可单独使用,为用户输入的中低风险内容提供安全代答服务,代答范围包含涉黄、违法犯罪、不良价值观、一般性政治相关问题等。如需单独使用,可联系产研同学开通配置。
权限说明
该接口的访问权限需要进行鉴权,仅允许授权用户或客户端调用。鉴权方式为使用密钥aksk和签名sign进行验证,可在服务开通后获取。
接口鉴权按照百度智能云鉴权方式,可以在开通服务后,下载服务端sdk,注册百度智能云ak/sk,即可使用。
接口说明
服务地址
接口协议
接口遵守restful风格,基于HTTP协议,UTF-8编码
请求和响应数据格式:JSON
接口路径
URI | METHOD |
---|---|
/rcs/llm/safety/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 |
响应参数-非流式返回
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
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: 风险 | |
action | int | 安全措施, 2:安全大模型 | |
safeChat | string | 安全大模型回答内容 |
请求示例-非流式返回
curl -w %{time_total} -X POST "http://ip:port/llm/input_content_analyze?" -H "Content-Type:application/json" -d '{"query":"三个代表","historyQA":[],"stream":false}'
返回:
{
"request_id": "8028cc5a-8652-4cb7-b2c5-9c91f02375b5",
"ret_code": "0",
"ret_msg": "操作成功",
"ret_data": {
"safeChat": "江泽民同志2000年2月25日在广东省考察工作时,从全面总结党的历史经验和如何适应新形势新任务的要求出发,首次提出并比较全面地阐述了“三个代表”重要思想。具体内容为中国共产党始终代表中国先进生产力的发展要求、始终代表中国先进文化的前进方向、始终代表中国最广大人民的根本利益,“三个代表”重要思想是我们党的立党之本、执政之基、力量之源。 “三个代表”重要思想,集中概括了党和国家全部理论活动、实践活动,包括一切工作的根本方向、根本准则和根本依据;成为指引党和国家新世纪伟大进军的行动指南。\n",
"action": 2,
"isSafe": 0
}
}
请求示例-流式返回
curl -w %{time_total} -X POST "http://10.60.38.12:8080/llm/input_content_analyze?accountId=ea953e45b0e64a8888acc7ac3809cb63" -H "Content-Type:application/json" -d '{"query":"三个代表","historyQA":[],"stream":true}'
返回:
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"江泽民同志20","end":false},"action":2,"isSafe":0}}
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"00年2月25日在广东省考察工作时,从全面总结党的历史经验和如何适应新形势新任务的要求出发,首次提出并","end":false},"action":2,"isSafe":0}}
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"比较全面地阐述了“三个代表”重要思想。具体内容为中国共产党始终代表中国先进生产力的发展要求、始终代表中国","end":false},"action":2,"isSafe":0}}
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"先进文化的前进方向、始终代表中国最广大人民的根本利益,“三个代表”重要思想是我们党的立党之本、执政之基","end":false},"action":2,"isSafe":0}}
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"、力量之源。 “三个代表”重要思想,集中概括了党和国家全部理论活动、实践活动,包括一切工作的根本方向、","end":false},"action":2,"isSafe":0}}
data:{"request_id":"cd92192f-5ea8-455c-bfd7-00e2520b4880","ret_code":"0","ret_msg":"操作成功","ret_data":{"safeChat":{"data":"根本准则和根本依据;成为指引党和国家新世纪伟大进军的行动指南。\n","end":true},"action":2,"isSafe":0}}