文档审核接口
更新时间：2026-08-07
接口描述
该接口为大模型安全场景提供文档风险审核能力，以及根据安全策略进行相应的处理和响应。它是基于自然语言处理、计算机视觉和机器学习等技术实现的。
权限说明
该接口的访问权限需要进行鉴权，仅允许授权用户或客户端调用。鉴权方式为使用密钥aksk和签名sign进行验证，可在服务开通后获取。
在开通服务后，接口鉴权按照百度智能云鉴权方式，或者参考服务端sdk，注册百度智能云ak/sk，即可使用。
接口说明
服务地址
接口协议
接口遵守restful风格，基于HTTP协议，UTF-8编码
请求和响应数据格式：JSON
接口路径
| 接口 | URI | METHOD | 描述 |
|---|---|---|---|
| 文档审核接口 | /rcs/llm/task/create | POST | 创建文档审核任务 |
| 审核结果获取接口 | /rcs/llm/task/detail | POST | 获取文档审核结果 |
文档审核接口
请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| files | List<String> | 是 | 文件 url 列表，文件限制 PDF、DOC、DOCX、XLS、XLSX、CSV、JSON、TXT、MD、MARKDOWN、MDX、HTM、HTML、XML、MSG、EML、EPUB、PPT、PPTX、PPSX、PPTM，文件大小若小于配置进行实时审核，超过配置进行离线审核 |
| type | int | 否 | 用户输入：1，模型输出：2，不填时默认为 1 |
| appid | string | 否 | 应用 ID：标识业务 |
| templateId | string | 否 | 模板 ID：管理控制台配置的策略模板的编码 ID，用于生效不同的策略模板 |
| userId | string | 否 | 用户 ID：用户唯一标识 |
| businessParams | string | 否 | 可用于接收离线审核推送结果的地址，业务透传字段的 json，示例：{"pushUrl": "http://riskv3.su.bcebos.com"} |
响应参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| request_id | string | 是 | 请求 id |
| ret_code | string | 是 | 返回状态码，0 表示成功，非 0 表示失败 |
| ret_msg | string | 是 | 返回信息，包括错误信息和警告信息等 |
| ret_data | Map<String,Object> | 是 | 返回结果，包括检测结果和处理结果等 |
ret_data 详细字段
| 参数名 | 类型 | 二级字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|---|---|
| taskIds | List<Map<string,object>> | ||||
| businessParams | string | 否 | 业务透传参数 | ||
| isSafe | string | 否 | 是否安全（实时审核时返回），0: 风险 1: 安全 | ||
| action | string | 否 | 安全措施（实时审核时返回），0：正常，6：不上屏 | ||
| originalFileUrl | string | 是 | 原始文件地址 | ||
| status | int | 是 | 审核是否完成：1=入库初始状态不处理，2=待处理，3=处理进度，5=处理失败，10=审核完成 | ||
| taskAuditUrl | string | 否 | 审核结果 url | ||
| taskId | string | 是 | 任务 ID |
示例
请求示例：
Bash
1curl --location --request POST 'http://ip:port/llm/task/create' \
2 -H "Content-Type:application/json" \
3 -d '{
4 "files": [
5 "https://riskv3.su.bcebos.com/wenku_20250829_v1.xlsx"
6 ],
7 "appid": "20250829",
8 "templateId": "12345",
9 "businessParams": "{\"pushUrl\":\"http://riskv3.xxx.xxxxx.com\"}"
10 }'响应示例：
JSON
1{
2 "request_id": "a16993eb-a591-4170-8df2-f4e20b4cd375",
3 "ret_code": "0",
4 "ret_msg": "操作成功",
5 "ret_data": {
6 "taskIds": [
7 {
8 "businessParams": "{\"pushUrl\":\"http://riskv3.su.bcebos.com\"}",
9 "originalFileUrl": "{\"pushUrl\":\"http://riskv3.1234.bcebos.com\"}",
10 "status": 1,
11 "taskId": "c29e9997-0ba7-41e6-92d0-290604b1822e"
12 }
13 ]
14 }
15}审核结果获取接口
请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| taskIds | List<String> | 是 | 接口返回的任务 ID |
| date | string | 是 | 任务 ID 日期格式 20251209 |
返回值
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| request_id | string | 是 | 请求 id |
| ret_code | string | 是 | 返回状态码，0 表示成功，非 0 表示失败 |
| ret_msg | string | 是 | 返回信息，包括错误信息和警告信息等 |
| ret_data | Map<String,Object> | 是 | 返回结果，包括检测结果和处理结果等 |
ret_data 详细字段
| 参数名 | 类型 | 是否必填 | 二级字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|---|---|---|
| task_list | List<Map<String,Object>> | 是 | ||||
| task_id | string | 是 | 任务 ID | |||
| isSafe | string | 否 | 是否安全（实时审核时返回），0: 风险 1: 安全 | |||
| action | string | 否 | 安全措施（实时审核时返回），0：正常，6：不上屏 | |||
| status | int | 是 | 审核是否完成：1=入库初始状态不处理，2=待处理，3=处理进度，5=处理失败，10=审核完成 | |||
| remark | string | 否 | 只有 status=5 时返回说明：file_url_invalid：文件 url 无效；file_content_invalid：文件格式无效或为空；to_origin_data_failed：服务处理失败 |
|||
| taskAuditUrl | string | 否 | 状态为 10 时存在，表示审核结果文件 url |
示例
请求示例：
Bash
1curl --location --request POST 'http://ip:port/llm/task/detail' \
2 -H "Content-Type:application/json" \
3 --data-raw '{
4 "taskIds": [
5 "11b553d7-93a3-4bf0-a152-6dd04ae1b73f"
6 ],
7 "date": "20251216",
8 "appid": 159
9 }'响应示例：
JSON
1{
2 "request_id": "88c8614a-1c5d-4abd-a3ec-1fcd195b0c52",
3 "ret_code": "0",
4 "ret_msg": "操作成功",
5 "ret_data": {
6 "task_list": [
7 {
8 "task_id": "a7aba91d-7372-42f3-bb62-2cfd5b8c6769",
9 "status": 10,
10 "taskAuditUrl": "http://10.37.116.233:8073/data/a7aba91d-7372-42f3-bb62-2cfd5b8c6769_result.md",
11 "action": 6,
12 "isSafe": 0
13 }
14 ]
15 }
16}评价此篇文章