数美智能文档识别产品API接口文档#

目录#

检测接口
结果查询接口

检测接口#

接口模式：本接口为异步检测。调用后 HTTP 响应（见请求即时响应）仅返回受理结果（code/message/requestId），不包含审核详情；完整审核结果通过 callback 回调推送，也可通过结果查询接口主动获取。

请求参数#

请求URL：#

集群	URL
北京	`http://api-article-bj.fengkongcloud.com/document/v4`
弗吉尼亚	`http://api-article-fjny.fengkongcloud.com/document/v4`
新加坡	`http://api-article-xjp.fengkongcloud.com/document/v4`

字符编码格式：#

UTF-8字符集编码

请求方法：#

POST

建议超时时长：#

15s

请求参数：#

放在HTTP Body中，采用Json格式，Body大小不可超过3.5M，具体参数如下：

请求参数名	类型	参数说明	是否必传	规范
accessKey	string	接口认证密钥	Y	由数美提供，用于权限认证，开通服务时由数美提供
appId	string	应用标识	Y	用于区分应用，需要联系数美服务开通，请使用数美单独提供的传值为准
eventId	string	事件标识	Y	用于区分场景数据，需要联系数美服务开通，请使用数美单独提供的传值为准
imgType	string	图片识别类型	Y	可选值： `NONE`：不审核图片 `POLITY`：涉政识别 `EROTIC`：色情&性感违规识别 `VIOLENT`：暴恐&违禁识别 `QRCODE`：二维码识别 `ADVERT`：广告识别 `IMGTEXTRISK`：图片文字违规识别（如需要识别图片里文字的违规内容，务必传入图片文字违规识别功能） `BOCR`：OCR小语种识别支持和语种自动检测（仅限新加坡集群）组合说明：除`NONE`以外都可以通过下划线组合，如`POLITY_QRCODE_ADVERT`用于涉政、二维码和广告组合识别。`NONE`不可以和其他type拼接
txtType	string	文本识别类型	Y	可选值： `NONE`：不审核文本 `POLITY`：涉政检测 `VIOLENT`：暴恐检测 `BAN`：违禁检测 `EROTIC`：色情检测 `DIRTY`：辱骂检测 `ADVERT`：广告检测 `PRIVACY`：隐私检测 `ADLAW`：广告法检测 `MEANINGLESS`：无意义检测 `FRUAD`：网络诈骗检测 `UNPOACH`：高价值用户防挖检测 `TEXTMINOR`：未成年人内容检测 `TEXTRISK`：常规风险检测（包含：涉政、暴恐、违禁、色情、辱骂、广告、隐私、广告法、无意义）组合说明：除`NONE`以外都可以通过下划线组合，如`TEXTRISK_FRUAD`。type间组合取并集，如`TEXTRISK_POLITY`按照常规风险检测处理。`NONE`不可以和其他type拼接
audioType	string	音频识别类型	N	可选值： `NONE`：不审核音频 `AUDIOPOLITICAL`：一号领导人声纹识别 `POLITY`：涉政识别 `EROTIC`：色情识别 `ADVERT`：广告识别 `ADLAW`：广告法识别 `BAN`：违禁识别 `VIOLENT`：暴恐识别 `ANTHEN`：国歌识别 `MOAN`：娇喘识别 `DIRTY`：辱骂识别 `BANEDAUDIO`：违禁歌曲 `COPYRIGHTSONGS`：版权歌曲组合说明：如需做组合识别，通过下划线连接即可，例如`POLITY_EROTIC_MOAN`用于涉政、色情和娇喘识别。建议传入：`POLITY_EROTIC_MOAN_ADVERT`。`NONE`不可以和其他type拼接
videoImgType	string	视频图片识别类型	N	可选值： `NONE`：不审核视频图片 `POLITY`：涉政识别 `EROTIC`：色情&性感违规识别 `VIOLENT`：暴恐&违禁识别 `QRCODE`：二维码识别 `ADVERT`：广告识别 `IMGTEXTRISK`：图片文字违规识别组合说明：如需识别多个功能，通过下划线连接，如`POLITY_QRCODE_ADVERT`用于涉政、二维码和广告组合识别。`NONE`不可以和其他type拼接
videoAudioType	string	视频音频识别类型	N	可选值： `NONE`：不检测视频中的音频 `POLITY`：涉政识别 `EROTIC`：色情识别 `ADVERT`：广告识别 `BAN`：违禁识别 `VIOLENT`：暴恐识别 `DIRTY`：辱骂识别 `ADLAW`：广告法识别 `MOAN`：娇喘识别 `AUDIOPOLITICAL`：一号领导人声纹识别 `ANTHEN`：国歌识别 `BANEDAUDIO`：违禁歌曲组合说明：如需做组合识别，通过下划线连接即可，例如`POLITY_EROTIC`用于涉政和色情识别。`NONE`不可以和其他type拼接
callback	string	回调http接口	Y	指定回调url地址。当该字段非空时，服务将根据该字段回调通知用户审核结果（支持`http`/`https`）
data	json_object	请求的数据内容	Y	最长1MB，详见data参数

其中，data的内容如下：

请求参数名	类型	参数说明	是否必传	规范
url	string	要检测的文档链接	Y	可下载文档链接，内容大小`500M`以内，文本长度默认限制`50万`字，图片张数默认限制`500张`。
fileFormat	string	要检测的文档格式	Y	注意：值必须与文档实际格式一致，否则将返回参数错误。详见fileFormat可选值
lang	string	待检测的文本内容语种	N	可选值和对应语种如下： `zh`：中文 `en`：英文 `ar`：阿拉伯语 `hi`：印地语 `es`：西班牙语 `fr`：法语 `ru`：俄语 `pt`：葡萄牙语 `id`：印尼语 `de`：德语 `ja`：日语 `tr`：土耳其语 `vi`：越南语 `it`：意大利语 `th`：泰语 `tl`：菲律宾语 `ko`：韩语 `ms`：马来语 `auto`：自动识别语种类型注意：默认值为`zh`。国内集群客户可不传或传入`zh`；海外文本内容如无法确定语种，建议传入`auto`，系统将自动检测语种类型
acceptLang	string	返回标签的语种类型	N	选择返回标签的语种类型可选值： `zh`：中文 `en`：英文不传入默认为返回中文标签
returnAllImg	int	返回图片的等级	N	可选值： `0`：返回风险等级为非pass的图片 `1`：返回所有风险等级的图片默认值为`0`
returnAllText	int	返回文本的等级	N	可选值： `0`：返回风险等级为非pass的文本 `1`：返回所有风险等级的文本默认值为`0`
returnAllVideoImg	int	返回视频里的图片的等级	N	可选值： `0`：返回风险等级为非pass的图片 `1`：返回所有风险等级的图片默认值为`0`
returnAllVideoAudio	int	返回视频里的音频的等级	N	可选值： `0`：返回风险等级为非pass的音频 `1`：返回所有风险等级的音频默认值为`0`
returnAllAudio	int	返回音频片段的等级	N	可选值： `0`：返回风险等级为非pass的音频 `1`：返回所有风险等级的音频默认值为`0`
tokenId	string	用户账号标识	Y	由数字、字母、下划线、短杠组成的长度小于等于64位的字符串。建议使用贵司用户UID（可加密）自行生成，标识用户唯一身份用作灌水和广告等行为维度风控。如无用户uid的场景建议使用唯一的数据标识传值
receiveTokenId	string	私聊场景下消息接收者的用户唯一标识	N	由数字、字母、下划线、短杠组成的字符串，长度小于等于64位
level	int	用户等级	N	针对不同等级的用户可配置不同拦截策略。可选值： `0`：最低级用户，典型如新注册、完全不活跃或等级为0的用户等 `1`：较低级用户，典型如低活跃或低等级用户等 `2`：中等级用户，典型如具备一定活跃或等级中等的用户等 `3`：较高级用户，典型如高活跃或高等级用户等 `4`：最高级用户，典型如付费用户、VIP用户等
gender	string	用户性别	N	可选值： `male`：男性 `female`：女性
nickname	string	用户昵称	N	校验昵称内容风险
ip	string	IP地址	N	发送该文本的用户公网IPv4或IPv6地址
deviceId	string	数美设备标识	N	数美设备指纹生成的设备唯一标识
dataId	string	数据标识	N	数据唯一标识，用于关联和追踪数据
extra	json_object	辅助参数	N	用于辅助文本检测的相关信息，详见extra参数

其中，fileFormat可选值如下：

可选值	含义	补充说明
`DOCX`	Word文档（新版）
`PDF`	PDF文档
`DOC`	Word文档（旧版）
`XLS`	Excel表格（旧版）
`XLSX`	Excel表格（新版）
`PPT`	PowerPoint演示文稿（旧版）
`PPTX`	PowerPoint演示文稿（新版）
`PPS`	PowerPoint幻灯片（旧版）
`PPSX`	PowerPoint幻灯片（新版）
`XLTX`	Excel模板（新版）
`XLTM`	Excel宏模板
`XLSB`	Excel二进制工作簿
`XLSM`	Excel宏工作簿
`TXT`	文本文件
`CSV`	逗号分隔值文件
`EPUB`	电子书格式
`MD`	Markdown文档
`SRT`	字幕文件
`VTT`	WebVTT字幕文件
`SB2`	Scratch 2.0 项目文件	提取舞台脚本文本、角色名称及内置图片/音频资源送审
`SB3`	Scratch 3.0 项目文件	提取积木脚本文本、角色/造型名称及内置图片/音频资源送审
`ZIP`	ZIP压缩包	解压后逐文件送审，详见压缩包内支持格式；嵌套解压需公司开通配置后可用（开通后默认最大嵌套层级2层、单请求最多处理3个子压缩包；未开通时包内压缩包按普通文件送审）；不支持加密压缩包；默认限制：解压后总大小100MB、最多500个文件、单文件最大50MB；解析失败返回`1904`，`message`可能为`archive corrupted`（文件损坏或无法打开）、`archive encrypted`（加密压缩包）、`archive unsupported file: {path}`（含白名单外格式）
`RAR`	RAR压缩包	同`ZIP`
`7Z`	7-Zip压缩包	同`ZIP`
`TAR_GZ`	tar.gz压缩包	同`ZIP`，也支持`.tgz`后缀
`GZ`	gzip单文件压缩包	同`ZIP`

压缩包内支持识别的文件格式（适用于 `ZIP`/`RAR`/`7Z`/`TAR_GZ`/`GZ`）：

解压后按文件后缀识别类型并逐文件送审。嵌套解压（包内 ZIP/RAR/7Z/TAR_GZ/GZ 继续解压送审）需公司在内部配置中开通；未开通时包内压缩包按普通文件送审。隐藏文件（. 开头）、__MACOSX 目录自动跳过。白名单外格式可能返回 archive unsupported file: {path}（取决于公司配置）。注意：压缩包内白名单与顶层 fileFormat 可选值不完全相同，如 CSV、XLSB、PPS 等顶层支持但包内不支持的格式，将视为白名单外文件。

分类	支持的后缀
文档（document）	`doc` `docx` `xls` `xlsx` `ppt` `pptx` `pdf` `txt` `md` `epub` `srt` `vtt` `sb2` `sb3`
图片（image）	`jpg` `jpeg` `png` `webp` `gif` `tiff` `tif` `heif` `heic` `avif` `apng` `bmp` `svg`
音频（audio）	`mp3` `aac` `ogg` `oga` `wma` `flac` `wav` `aiff` `aif` `pcm`
视频（video）	`mp4` `mov` `avi` `mkv` `flv` `wmv`
代码（code）	`go` `py` `java` `js` `jsx` `ts` `tsx` `c` `cpp` `h` `hpp` `cs` `php` `rb` `rs` `swift` `kt` `html` `css` `json` `xml` `yaml` `yml` `sh` `bat` `ps1` `sql` `vim` `lua` `pl` `r` `scala` `dart`

data 中 extra数组每个元素的内容如下：

请求参数名	类型	参数说明	是否必传	规范
room	string	直播间/游戏房间编号	N	传入的是直播间、聊天室等数据（eventId值为groupChat）时，开启上下文识别功能，建议传入，否则不能关联上下文
passThrough	json_object	透传字段	N	客户传入的透传字段，数美内部不会对该字段进行识别处理，随结果返回给用户

请求即时响应#

说明：调用检测接口后，服务端立即返回以下参数，表示请求是否受理成功。此处不是审核结果，不含 riskLevel、textDetails 等字段；审核结果请查看回调返回结果或使用结果查询接口。

放在HTTP Body中，采用Json格式，具体参数如下：

参数名称	类型	参数说明	是否必返	规范
code	int	返回码	Y	`1100`：成功 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败 `9100`：余额不足 `9101`：无权限操作
message	string	返回码描述	Y	和code对应：成功 QPS超限参数不合法服务失败余额不足无权限操作
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存

回调返回结果#

说明：当请求参数中传入了callback回调地址时，完整的结果数据将通过回调接口异步返回。以下参数中，除code、message、requestId以外，其他必返参数仅在code返回1100时返回。

放在HTTP Body中，采用Json格式，具体参数如下：

参数名称	类型	参数说明	是否必返	规范
code	int	返回码	Y	`1100`：成功 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败 `1904`：内容获取失败 `1905`：内容格式错误 `9100`：余额不足 `9101`：无权限操作
message	string	返回码描述	Y	与 `code` 对应。`code` 为 `1904`/`1905` 时仅返回 `code`、`message`、`requestId` 三个字段。 `1904`：可能为 `get content has errors`（URL 无法访问、下载失败等）；压缩包解析失败时可能为 `archive corrupted`（文件损坏）、`archive encrypted`（加密压缩包）、`archive unsupported file: {path}`（含不支持格式）、`archive extract size {size}MB exceeds limit {limit}MB`（解压超限）等。 `1905`：可能为 `content format has errors`（文件超过 500MB、格式无法解析、无可审核内容等）；数量超限时可能为 `word count limit, quota: {quota}, current: {current}`（`image`/`audio`/`video` 同理）。其余 `code` 的 `message`：成功、QPS超限、参数不合法、服务失败、余额不足、无权限操作
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
textDetails	json_array	文本风险详情	Y	文档中文本的风险详情，详见textDetails参数
imgDetails	json_array	图片风险详情	Y	文档中图片的风险详情，详见imgDetails参数
audioDetails	json_array	音频风险详情	Y	文档中音频的风险详情，详见audioDetails参数
videoDetails	json_array	视频风险详情	Y	文档中视频的风险详情，详见videoDetails参数
auxInfo	json_object	辅助信息	Y	详见auxInfo参数
resultType	int	结果类型	Y	当前结果类型 `0`：机审 `1`：人审
finalResult	int	是否为最终审核结果	Y	是否为最终审核结果（如仅接入机审，则默认返回1）。 `0`：非最终结果。说明该结果为数美风控的机审结果，还需要经过数美人审再次审核后回传贵司。 `1`：最终结果。贵司可直接拿返回结果进行处置、分发等下游场景的使用。

其中，textDetails的内容如下：

参数名称	类型	参数说明	是否必返	规范
code	int	返回码	Y	`1100`：成功 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败
message	string	返回码描述	Y	和code对应：成功、QPS超限、参数不合法、服务失败、字数超限
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
riskLabel1	string	一级风险标签	Y	一级风险标签，当riskLevel为`PASS`时返回`normal`
riskLabel2	string	二级风险标签	Y	二级风险标签，当riskLevel为`PASS`时为空
riskLabel3	string	三级风险标签	Y	三级风险标签，当riskLevel为`PASS`时为空
riskDescription	string	风险原因	Y	当riskLevel为`PASS`时为"正常"
riskDetail	json_object	风险详情	Y	风险详情，详见riskDetail参数
tokenLabels	json_object	账号风险画像标签信息	Y	账号风险画像标签信息，详见tokenLabels参数
auxInfo	json_object	辅助信息	Y	辅助信息，详见auxInfo参数
allLabels	json_array	风险标签列表	Y	命中的所有风险标签以及详情信息，详见allLabels参数
businessLabels	json_array	业务标签	Y	命中的所有业务标签以及详细信息，详见businessLabels参数
tokenProfileLabels	json_array	账号属性标签	N	属性账号类标签，仅在提供tokenId并开通标签服务时返回，详见账号标签参数
tokenRiskLabels	json_array	账号风险标签	N	风险账号类标签，仅在提供tokenId并开通标签服务时返回，详见账号标签参数
langResult	json_object	语种信息	N	语种识别和翻译结果，详见langResult参数

其中，textDetails的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
matchedLists	json_array	命中的客户自定义名单列表	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险内容片段	N	检测文本包含涉政、暴恐、违禁、广告法等风险内容的时候存在，详见riskSegments参数

其中，textDetails的riskDetail下matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的敏感词数组	N	命中的敏感词数组，详见words参数

其中，matchedLists中，words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，textDetails的riskDetail下riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置

其中，allLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskLevel	string	风险等级	Y	可能返回值： `REVIEW`：可疑 `REJECT`：违规
riskLabel1	string	一级风险标签	Y	allLabels不为空时必返
riskLabel2	string	二级风险标签	Y	allLabels不为空时必返
riskLabel3	string	三级风险标签	Y	allLabels不为空时必返
riskDescription	string	风险原因	Y	allLabels不为空时必返
probability	float	置信度	Y	可选值在0～1之间，值越大，可信度越高。注意：allLabels不为空时必返
riskDetail	json_object	映射后风险详情	Y	格式与上层riskDetail结构相同。注意：allLabels不为空时必返，详见riskDetail参数

其中，allLabels的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
matchedLists	json_array	命中的客户自定义名单列表	N	命中的客户自定义名单列表，详见matchedLists参数
riskSegments	json_array	高风险内容片段	N	高风险内容片段，检测文本包含涉政、暴恐、违禁、广告法等风险内容的时候存在，详见riskSegments参数

其中，allLabels的riskDetail下matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的敏感词数组	N	命中的敏感词数组，详见words参数

其中，allLabels的riskDetail下matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，allLabels的riskDetail下riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置

其中，tokenLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
UGC_account_risk	json_object	UGC内容相关风险	N	UGC内容相关风险，详见UGC_account_risk参数

其中，tokenLabels的UGC_account_risk的内容如下：

参数名称	类型	参数说明	是否必返	规范
sexy_risk_tokenid	float	色情账号风险分	N	色情账号风险分，取值区间[0-1]

其中，textDetails的auxInfo的内容如下：

参数名称	类型	参数说明	是否必返	规范
filteredText	string	风险片段被替换为*后的文本	N	风险片段被替换为*后的文本
passThrough	json_object	透传字段	N	该字段内容与请求参数data中extra的passThrough的值相同
contactResult	json_array	联系方式识别结果	N	联系方式识别结果，包含识别出的微信、QQ、手机号的字符串类型和内容，详见contactResult参数
contextText	string	上下文文本	N	上下文生效时返回
unauthorizedType	string	未授权的type	N	未授权的type

其中，textDetails的auxInfo的contactResult数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
contactType	int	联系方式类型	N	联系方式类型，可选值： `0`：手机号 `1`：QQ号 `2`：微信号
contactString	string	联系方式串	N	联系方式串

其中，businessLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
businessLabel1	string	一级业务标签	Y	businessLabels不为空必返
businessLabel2	string	二级业务标签	Y	businessLabels不为空必返
businessLabel3	string	三级业务标签	Y	businessLabels不为空必返
businessDescription	string	标签描述	Y	businessLabels不为空必返
probability	float	置信度	Y	可选值在0～1之间，值越大，可信度越高。businessLabels不为空必返
businessDetail	json_object	业务详情	Y	businessLabels不为空必返

其中，langResult的内容如下：

参数名称	类型	参数说明	是否必返	规范
detectedLang	string	语种识别结果	N	当在国际化文本产品下传入lang的值为`auto`时返回该字段。值为标准语言代码表，例如：`zh`、`en`、`ar`等
translatedText	string	文本翻译结果	N	当传入`translationTargetLang`时返回该字段。值为翻译后的文本

其中，tokenProfileLabels、tokenRiskLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
label1	string	一级标签	N
label2	string	二级标签	N
label3	string	三级标签	N
description	string	标签描述	N
timestamp	int	打标签时间戳	N	13位Unix时间戳，单位：毫秒

其中，imgDetails的内容如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
message	string	返回码描述	Y	和code对应：成功、QPS超限、参数不合法、服务失败、字数超限
code	int	返回码	Y	`1100`：成功 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败 `1911`：图片下载失败
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
riskLabel1	string	一级风险标签	Y	一级风险标签，当riskLevel为`PASS`时返回`normal`
riskLabel2	string	二级风险标签	Y	二级风险标签，当riskLevel为`PASS`时为空
riskLabel3	string	三级风险标签	Y	三级风险标签，当riskLevel为`PASS`时为空
riskDescription	string	风险原因	Y	当riskLevel为`PASS`时为"正常"
resultType	int	当前结果是机审还是人审环节结果	Y	可选值： `0`：机审 `1`：人审
finalResult	int	是否最终结果	Y	可选值： `0`：不是最终结果，该结果为数美风控的过程结果，还需要经过数美人审再次check后回传 `1`：最终结果，可直接拿返回结果进行处置、分发等下游场景的使用
auxInfo	json_object	辅助信息	Y	辅助信息，详见auxInfo参数
allLabels	json_array	风险标签列表	Y	命中的所有风险标签以及详情信息，详见allLabels参数
businessLabels	json_array	业务标签	N	命中的所有业务标签以及详细信息，详见businessLabels参数
riskDetail	json_object	风险详情	Y	风险详情，详见riskDetail参数
disposal	json_object	处置和映射结果	N	数美可按照贵司的标签体系和标识进行返回；未配置自定义标签体系则不返回该字段，详见disposal参数
tokenLabels	json_object	账号风险画像标签信息	Y	账号风险画像标签信息，仅在提供tokenId并联系数美开通时返回，详见tokenLabels参数
tokenProfileLabels	json_array	辅助信息	N	属性账号类标签，仅在提供tokenId并开通标签服务时返回。详见账号标签参数
tokenRiskLabels	json_array	辅助信息	N	风险账号类标签，仅在提供tokenId并开通标签服务时返回。详见账号标签参数

其中，imgDetails的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1002`：视觉图片风险
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
ocrText	json_object	返回图片中文字识别内容	N	当请求参数imgType字段包含`IMGTEXTRISK`或`ADVERT`时存在，详见ocrText参数
persons	json_array	图片中人物的名称及位置信息	N	仅当命中人像-多人时，数组元素会有多个，最多10个，详见persons参数

其中，imgDetails的riskDetail下faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	人物编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	能识别的公众人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的riskDetail下objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	二维码地址	N	仅当命中二维码相关标签时返回
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的riskDetail下persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	人物编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，imgDetails的riskDetail下ocrText的内容如下：

参数名称	类型	参数说明	是否必返	规范
text	string	图片中识别出的文字	Y	图片中识别出的文字
matchedLists	json_array	命中的客户自定义名单列表	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、广告法等风险内容的时候存在，详见riskSegments参数

其中，imgDetails的riskDetail下ocrText的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的敏感词信息	N	命中的这个名单中的敏感词信息，详见words参数

其中，imgDetails的riskDetail下ocrText的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，imgDetails的riskDetail下ocrText的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，imgDetails的auxInfo的内容如下：

参数名称	类型	参数说明	是否必返	规范
segments	int	实际处理的片段数	Y	实际处理的片段数
typeVersion	json_object	模型版本号	Y	对应传入type值的模型版本号，详见typeVersion参数
errorCode	int	错误码	N	可选值： `2001`：输入数据格式不正确，不是有效的JSON数据 `2002`：输入参数字段非法（缺少必填字段、类型错误、取值非法等） `2003`：图片下载失败 `2004`：图片过大，超过10M `2005`：非法图片格式 `2006`：非法风险监控类型
frameTime	int	截帧时间戳	N	当请求参数传入`streamInfo`功能时返回相似功能。13位毫秒级时间戳
qrContent	string	二维码地址	N	返回图片中识别的二维码地址
streamId	string	流标识	N	请求参数中包含streamInfo等参数，传入后会返回相似功能
passThrough	json_object	透传字段	N	客户传入的透传字段。数美内部不会识别处理该字段，随结果返回给用户

其中，imgDetails的auxInfo的typeVersion的内容如下：

参数名称	类型	参数说明	是否必返	规范
ADVERT	string	广告版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`
EROTIC	string	色情版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`
IMGTEXTRISK	string	图片文字违规版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`
POLITY	string	涉政版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`
QRCODE	string	二维码版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`
VIOLENT	string	暴恐版本号	N	格式为`X.Y`，其中`X`表示主版本号，通常表示模型整体效果迭代；`Y`表示次版本号，通常表示日常例行迭代。例如`1001001.2`表示主版本号为`1001001`，次版本号为`2`

其中，imgDetails的allLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskLevel	string	风险等级	Y	可能返回值： `REVIEW`：可疑 `REJECT`：违规
riskLabel1	string	一级风险标签	Y	allLabels不为空时必返
riskLabel2	string	二级风险标签	Y	allLabels不为空时必返
riskLabel3	string	三级风险标签	Y	allLabels不为空时必返
riskDescription	string	风险原因	Y	allLabels不为空时必返。当riskLevel为PASS时返回正常；其他情况展现形式为："一级标签:二级标签:三级标签"的中文名。仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高。注意：allLabels不为空时必返
riskDetail	json_object	映射后风险详情	Y	格式与imgDetails的riskDetail结构相同。注意：allLabels不为空时必返，详见riskDetail参数

其中，imgDetails的allLabels的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1002`：视觉图片风险
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
ocrText	json_object	返回图片中文字识别内容	N	当请求参数imgType字段包含IMGTEXTRISK或ADVERT时存在，详见ocrText参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，imgDetails的allLabels的riskDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的allLabels的riskDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	返回图片中识别的二维码地址	N	返回图片中识别的二维码地址
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的allLabels的riskDetail的ocrText的内容如下：

参数名称	类型	参数说明	是否必返	规范
text	string	图片中识别出的文字	Y	图片中识别出的文字
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，imgDetails的allLabels的riskDetail的ocrText的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，imgDetails的allLabels的riskDetail的ocrText的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，imgDetails的allLabels的riskDetail的ocrText的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，imgDetails的allLabels的riskDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，imgDetails的businessLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
businessDescription	string	业务标签描述	Y	格式为"一级标签:二级标签:三级标签"的中文名称
businessLabel1	string	一级业务标签	Y	一级业务标签
businessLabel2	string	二级业务标签	Y	二级业务标签
businessLabel3	string	三级业务标签	Y	三级业务标签
probability	float	置信度	Y	可选值在0～1之间，值越大，可信度越高
confidenceLevel	int	置信等级	N	可选值在0～2之间，值越大，可信度越高
businessDetail	json_object	业务标签详情	N	详见businessDetail参数

其中，imgDetails的businessLabels的businessDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_compare_num	int	人脸对比数量	N	当传入FACECOMPARE业务类型和imgCompareBase时存在。imgCompareBase检测传入图片中的人脸数量
face_num	int	人脸数量	N	人脸数量
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
name	string	人物名称	N	人物名称
person_num	int	人像数量	N	人像数量
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
location	int_array	位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，imgDetails的businessLabels的businessDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的businessLabels的businessDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	返回图片中识别的二维码地址	N	返回图片中识别的二维码地址
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的businessLabels的businessDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，imgDetails的disposal的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskDescription	string	映射后风险原因	Y	当riskLevel为PASS时为正常
riskLabel1	string	映射后一级风险标签	Y	一级风险标签，当数美标签未映射上自定义标签，且disposal下的riskLevel为PASS时，riskLabel1值为normal
riskLabel2	string	映射后二级风险标签	Y	二级风险标签，当数美标签未映射上自定义标签，且disposal下的riskLevel为PASS时，riskLabel2值为空
riskLabel3	string	映射后三级风险标签	Y	三级风险标签，当数美标签未映射上自定义标签，且disposal下的riskLevel为PASS时，riskLabel3值为空
riskLevel	string	处置建议	Y	若贵司有自己的处置规则，数美可按照贵司的处置逻辑配置并返回对应的处置建议；若规则标签未映射上，则返回默认处置建议
riskDetail	json_object	映射后风险详情	Y	格式与imgDetails的riskDetail结构相同，详见riskDetail参数

其中，imgDetails的disposal的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1002`：视觉图片风险
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
ocrText	json_object	返回图片中文字识别内容	N	当请求参数imgType字段包含IMGTEXTRISK或ADVERT时存在，详见ocrText参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，imgDetails的disposal的riskDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的disposal的riskDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	返回图片中识别的二维码地址	N	返回图片中识别的二维码地址
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，imgDetails的disposal的riskDetail的ocrText的内容如下：

参数名称	类型	参数说明	是否必返	规范
text	string	图片中识别出的文字	Y	图片中识别出的文字
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，imgDetails的disposal的riskDetail的ocrText的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，imgDetails的disposal的riskDetail的ocrText的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，imgDetails的disposal的riskDetail的ocrText的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，imgDetails的disposal的riskDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，imgDetails的tokenLabels的内容如下：

参数名称	类型	参数说明	是否必返	规范
UGC_account_risk	json_object	UGC内容相关风险	N	UGC内容相关风险，详见UGC_account_risk参数
machine_account_risk	json_object	机器控制相关风险	N	机器控制相关风险，详见machine_account_risk参数
scene_account_risk	json_object	场景账号风险	N	场景账号风险，仅在特殊场景下可获得，如航空公司等，详见scene_account_risk参数

其中，imgDetails的tokenLabels的UGC_account_risk的内容如下：

参数名称	类型	参数说明	是否必返	规范
b_advertise_risk_tokenid	int	广告风险	N	可选值： `0`：当前未检测到广告风险 `1`：存在广告风险
b_advertise_risk_tokenid_last_ts	int	广告风险时间	N	广告风险时间戳
b_politics_risk_tokenid	int	涉政风险	N	可选值： `0`：当前未识别到涉政风险 `1`：存在涉政风险
b_politics_risk_tokenid_last_ts	int	涉政风险时间	N	涉政风险时间戳
b_sexy_risk_tokenid	int	色情风险	N	可选值： `0`：当前暂时未检测到色情风险 `1`：存在色情风险
b_sexy_risk_tokenid_last_ts	int	色情风险时间	N	色情风险时间戳

其中，imgDetails的tokenLabels的machine_account_risk的内容如下：

参数名称	类型	参数说明	是否必返	规范
b_machine_control_tokenid	int	机器账号	N	可选值： `0`：非机器控制账号 `1`：机器控制账号
b_machine_control_tokenid_last_ts	int	机器账号时间	N	机器账号时间戳
b_offer_wall_tokenid	int	积分墙账号	N	可选值： `0`：非积分墙账号 `1`：积分墙账号
b_offer_wall_tokenid_last_ts	int	积分墙账号时间	N	积分墙账号时间戳

其中，imgDetails的tokenLabels的scene_account_risk的内容如下：

参数名称	类型	参数说明	是否必返	规范
i_tout_risk_tokenid	int	航空公司占座账号	N	可选值： `0`：非航空公司占座账号 `1`：航空公司占座账号
i_tout_risk_tokenid_last_ts	int	航空公司占座时间	N	航空公司占座时间戳

其中，audioDetails的内容如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	请求标识	Y	本次请求的唯一标识，用于问题排查和效果优化，强烈建议保存
code	int	返回码	Y	`1100`：成功 `1101`：正在处理中 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败 `1904`：下载失败 `1905`：解码失败 `9100`：余额不足除message和requestId之外的字段，只有当code为1100时才会存在
message	string	返回码描述	Y	和code对应：成功、正在处理中、QPS超限、参数不合法、服务失败、下载失败、解码失败、余额不足
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截建议：对接初期不直接使用结果，进行拦截尺度调优，符合预期后再进行使用
audioText	string	整段音频转译文本结果	Y	整段音频转译文本结果
audioTime	int	整段音频的音频时长	Y	单位秒
audioDetail	json_array	音频片段信息	Y	回调的音频片段信息，详见audioDetail参数

其中，audioDetail具体参数如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	请求标识	Y	音频片段请求唯一标识
audioStarttime	float	音频片段起始时间	Y	相对音频开始的时间距离，单位是秒
audioEndtime	float	音频片段结束时间	Y	相对音频开始的时间距离，单位是秒
audioUrl	string	音频片段链接	Y	mp3格式
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
businessLabels	json_array	业务标签	N	命中的所有业务标签以及详细信息，详见businessLabels参数
allLabels	json_array	风险标签列表	N	命中的所有风险标签以及详情信息，详见allLabels参数
riskLabel1	string	一级风险标签	Y	一级风险标签，当riskLevel为`PASS`时返回`normal`
riskLabel2	string	二级风险标签	Y	二级风险标签，当riskLevel为`PASS`时为空
riskLabel3	string	三级风险标签	Y	三级风险标签，当riskLevel为`PASS`时为空
riskDescription	string	风险原因	Y	当riskLevel为`PASS`时为"正常"
riskDetail	json_object	风险详情	N	风险详情，详见riskDetail参数

其中，audioDetail的businessLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
businessLabel1	string	一级业务标签	Y	一级业务标签
businessLabel2	string	二级业务标签	Y	二级业务标签
businessLabel3	string	三级业务标签	Y	三级业务标签
businessDescription	string	业务标签描述	Y	格式为"一级标签:二级标签:三级标签"的中文名称
confidenceLevel	int	置信等级	N	可选值在0～2之间，值越大，可信度越高
probability	float	置信度	Y	可选值为0~1，值越大，可信度越高
businessDetail	json_object	业务标签详情	N	保留字段

其中，audioDetail的allLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskLevel	string	风险等级	Y	可能返回值： `REVIEW`：可疑 `REJECT`：违规
riskLabel1	string	一级风险标签	Y	allLabels不为空时必返
riskLabel2	string	二级风险标签	Y	allLabels不为空时必返
riskLabel3	string	三级风险标签	Y	allLabels不为空时必返
riskDescription	string	风险原因	Y	allLabels不为空时必返。当riskLevel为PASS时返回正常；其他情况展现形式为："一级标签:二级标签:三级标签"的中文名。仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
probability	float	置信度	N	可选值在0～1之间，值越大，风险可能性越高，值越小，无风险可能性越高。注意：allLabels不为空时必返
riskDetail	json_object	映射后风险详情	Y	格式与audioDetail的riskDetail结构相同。注意：allLabels不为空时必返，详见riskDetail参数

其中，audioDetail的allLabels的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1003`：音频语音风险
audioText	string	音频转译文本的结果	N	音频转译文本的结果
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险内容片段	N	详见riskSegments参数

其中，audioDetail的allLabels的riskDetail的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	客户自定义名单名称	Y	客户自定义名单名称
words	json_array	命中的这个名单中的敏感词信息	Y	详见words参数

其中，audioDetail的allLabels的riskDetail的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	敏感词	Y	敏感词
position	int_array	敏感词所在位置	Y	敏感词所在位置

其中，audioDetail的allLabels的riskDetail的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置

其中，audioDetail的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1003`：音频语音风险
audioText	string	音频转译文本的结果	N	音频转译文本的结果
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险内容片段	N	详见riskSegments参数

其中，audioDetail的riskDetail的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	客户自定义名单名称	Y	客户自定义名单名称
words	json_array	命中的这个名单中的敏感词信息	Y	详见words参数

其中，audioDetail的riskDetail的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	敏感词	Y	敏感词
position	int_array	敏感词所在位置	Y	敏感词所在位置

其中，audioDetail的riskDetail的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置

其中，videoDetails具体参数如下：

参数名称	类型	参数说明	是否必返	规范
code	int	返回码	Y	`1100`：成功 `1901`：QPS超限 `1902`：参数不合法 `1903`：服务失败 `1905`：字数超限
message	string	返回码描述	Y	和code对应：成功、QPS超限、参数不合法、服务失败、字数超限
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
frameDetail	json_array	风险详情	N	有风险片段或returnAllVideoImg=1时返回，详见frameDetail说明
audioDetail	json_array	音频片段信息	N	有风险片段或returnAllVideoAudio=1时返回，详见audioDetail说明
auxInfo	json_object	辅助信息	N	code为1100时存在，详见auxInfo说明
tokenProfileLabels	json_array	账号属性标签	N	仅在开启功能时返回，详见tokenProfileLabels说明
tokenRiskLabels	json_array	账号风险标签	N	仅在开启功能时返回，详见tokenProfileLabels说明

其中，frameDetail具体参数如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
imgUrl	string	截帧图片地址	Y	截帧图片地址
riskDescription	string	风险描述	Y	当riskLevel为`PASS`时返回：正常。格式为："一级风险标签：二级风险标签：三级风险标签"，的中文名称。对于命中用户自定义名单时返回：命中自定义名单。
riskLabel1	string	一级风险标签	Y	一级风险标签，当riskLevel为`PASS`时返回`normal`
riskLabel2	string	二级风险标签	Y	二级风险标签，当riskLevel为`PASS`时为空
riskLabel3	string	三级风险标签	Y	三级风险标签，当riskLevel为`PASS`时为空
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
allLabels	json_array	风险标签列表	Y	命中的所有风险标签以及详情信息，详见allLabels参数
auxInfo	json_object	辅助信息	Y	辅助信息，详见auxInfo参数
riskDetail	json_object	风险详情	Y	风险详情，详见riskDetail参数
imgText	string	截帧图片OCR文本内容	N	截帧图片OCR文字识别，仅传入ADVERT、IMGTEXTRISK时返回
time	float	截帧在视频文件中的时间	N	截帧图片相对视频文件的时间，单位为秒
businessLabels	json_array	业务标签	N	命中的所有业务标签以及详细信息，详见businessLabels参数

其中，frameDetail的allLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskLevel	string	风险等级	Y	可能返回值： `REVIEW`：可疑 `REJECT`：违规
riskLabel1	string	一级风险标签	Y	allLabels不为空时必返
riskLabel2	string	二级风险标签	Y	allLabels不为空时必返
riskLabel3	string	三级风险标签	Y	allLabels不为空时必返
riskDescription	string	风险原因	Y	allLabels不为空时必返。当riskLevel为PASS时返回正常；其他情况展现形式为："一级标签:二级标签:三级标签"的中文名。仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高。注意：allLabels不为空时必返
riskDetail	json_object	映射后风险详情	Y	格式与frameDetail的riskDetail结构相同。注意：allLabels不为空时必返，详见riskDetail参数

其中，frameDetail的allLabels的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1002`：视觉图片风险
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
ocrText	json_object	返回图片中文字识别内容	N	当请求参数imgType字段包含IMGTEXTRISK或ADVERT时存在，详见ocrText参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，frameDetail的allLabels的riskDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	人物编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	能识别的公众人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的allLabels的riskDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	二维码地址	N	仅当命中二维码相关标签时返回
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的allLabels的riskDetail的ocrText的内容如下：

参数名称	类型	参数说明	是否必返	规范
text	string	图片中识别出的文字	Y	图片中识别出的文字
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，frameDetail的allLabels的riskDetail的ocrText的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，frameDetail的allLabels的riskDetail的ocrText的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，frameDetail的allLabels的riskDetail的ocrText的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，frameDetail的allLabels的riskDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	人物编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，frameDetail的auxInfo的内容如下：

参数名称	类型	参数说明	是否必返	规范
similarity	float	相似度	Y	返回当前截帧图片和上一帧截帧图片的相似度。视频文件初始第一帧将比对纯黑背景图片。与上一张截帧图片的相似概率值，取值范围[0-1]，数值越接近1越相似
qrContent	string	二维码地址	N	返回图片中识别的二维码地址

其中，frameDetail的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1002`：视觉图片风险
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
ocrText	json_object	返回图片中文字识别内容	N	当请求参数imgType字段包含IMGTEXTRISK或ADVERT时存在，详见ocrText参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，frameDetail的riskDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	人物编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	能识别的公众人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的riskDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	二维码地址	N	仅当命中二维码相关标签时返回
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的riskDetail的ocrText的内容如下：

参数名称	类型	参数说明	是否必返	规范
text	string	图片中识别出的文字	Y	图片中识别出的文字
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，frameDetail的riskDetail的ocrText的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	命中的名单名称	N	命中的名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，frameDetail的riskDetail的ocrText的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置

其中，frameDetail的riskDetail的ocrText的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，frameDetail的riskDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	人物编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，frameDetail的businessLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
businessDescription	string	业务标签描述	Y	格式为"一级标签:二级标签:三级标签"的中文名称
businessLabel1	string	一级业务标签	Y	一级业务标签
businessLabel2	string	二级业务标签	Y	二级业务标签
businessLabel3	string	三级业务标签	Y	三级业务标签
probability	float	置信度	Y	可选值在0～1之间，值越大，可信度越高
confidenceLevel	int	置信等级	N	可选值在0～2之间，值越大，可信度越高
businessDetail	json_object	业务标签详情	N	详见businessDetail参数

其中，frameDetail的businessLabels的businessDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_num	int	人脸数量	N	人脸数量
person_num	int	人像数量	N	人像数量
faces	json_array	图片中涉政人物的名称及位置信息	N	当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见faces参数
objects	json_array	物品信息	N	返回图片中标识或物品的名称及位置信息，详见objects参数
persons	json_array	图片中人物的名称及位置信息	N	当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个），详见persons参数

其中，frameDetail的businessLabels的businessDetail的faces数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
face_ratio	float	人脸占比	N	在区间0-1，数值越大，人脸占比越高
id	string	人物编号	N	图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
name	string	人物名称	N	能识别的公众人物名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人物位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的businessLabels的businessDetail的objects数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	物品或标识编号	N	保证同一个位置下的物品在不同标签下的编号相同
name	string	物品名称	N	物品名称
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
qrContent	string	二维码地址	N	仅当命中二维码相关标签时返回
location	int_array	物品位置信息	N	该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标

其中，frameDetail的businessLabels的businessDetail的persons数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
id	string	人物编号	N	保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	人像占比	N	在区间0-1，数值越大，人脸占比越高
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高
location	int_array	人像位置坐标	N	人像位置坐标

其中，videoDetails的audioDetail具体参数如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	请求标识	Y	本次请求数据的唯一标识，用于问题排查和效果优化，强烈建议保存
audioUrl	string	音频片段地址	Y	音频片段地址
riskDescription	string	风险描述	Y	当riskLevel为`PASS`时返回：正常。格式为："一级风险标签：二级风险标签：三级风险标签"，的中文名称。对于命中用户自定义名单时返回：命中自定义名单。
riskLabel1	string	一级风险标签	Y	一级风险标签，当riskLevel为`PASS`时返回`normal`
riskLabel2	string	二级风险标签	Y	二级风险标签，当riskLevel为`PASS`时为空
riskLabel3	string	三级风险标签	Y	三级风险标签，当riskLevel为`PASS`时为空
riskLevel	string	处置建议	Y	可能返回值： `PASS`：正常，建议直接放行 `REVIEW`：可疑，建议人工审核 `REJECT`：违规，建议直接拦截
allLabels	json_array	风险标签列表	Y	命中的所有风险标签以及详情信息，详见allLabels参数
audioEndtime	float	音频片段结束时间	N	相对音频开始时间的距离，单位是秒
audioStarttime	float	音频片段开始时间	N	相对音频开始时间的距离，单位是秒
audioText	string	该片段识别的文字内容	N	该片段识别的文字内容
businessLabels	json_array	业务标签	N	命中的所有业务标签以及详细信息，详见businessLabels参数
riskDetail	json_object	风险详情	N	风险详情，详见riskDetail参数

其中，videoDetails的audioDetail的allLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskLevel	string	风险等级	Y	可能返回值： `REVIEW`：可疑 `REJECT`：违规
riskLabel1	string	一级风险标签	Y	allLabels不为空时必返
riskLabel2	string	二级风险标签	Y	allLabels不为空时必返
riskLabel3	string	三级风险标签	Y	allLabels不为空时必返
riskDescription	string	风险原因	Y	allLabels不为空时必返。当riskLevel为PASS时返回正常；其他情况展现形式为："一级标签:二级标签:三级标签"的中文名。仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
probability	float	置信度	N	可选值在0～1之间，值越大，可信度越高。注意：allLabels不为空时必返
riskDetail	json_object	映射后风险详情	Y	格式与videoDetails的audioDetail的riskDetail结构相同。注意：allLabels不为空时必返，详见riskDetail参数

其中，videoDetails的audioDetail的allLabels的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1003`：音频语音风险
audioText	string	该片段识别的文字内容	N	该片段识别的文字内容
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，videoDetails的audioDetail的allLabels的riskDetail的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	名单名称	N	名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，videoDetails的audioDetail的allLabels的riskDetail的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置，下标从0开始计数

其中，videoDetails的audioDetail的allLabels的riskDetail的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，videoDetails的audioDetail的businessLabels数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
businessDescription	string	业务标签描述	Y	格式为"一级标签:二级标签:三级标签"的中文名称
businessLabel1	string	一级业务标签	Y	一级业务标签
businessLabel2	string	二级业务标签	Y	二级业务标签
businessLabel3	string	三级业务标签	Y	三级业务标签
probability	float	置信度	Y	可选值在0～1之间，值越大，可信度越高
confidenceLevel	int	置信等级	N	可选值在0～2之间，值越大，可信度越高
businessDetail	json_object	业务标签详情	N	详见businessDetail参数

其中，videoDetails的audioDetail的businessLabels的businessDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1003`：音频语音风险
audioText	string	该片段识别的文字内容	N	该片段识别的文字内容
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测音频包含未成年，唱歌等风险内容的时候存在，详见riskSegments参数

其中，videoDetails的audioDetail的businessLabels的businessDetail的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	名单名称	N	名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，videoDetails的audioDetail的businessLabels的businessDetail的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置，下标从0开始计数

其中，videoDetails的audioDetail的businessLabels的businessDetail的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，videoDetails的audioDetail的riskDetail的内容如下：

参数名称	类型	参数说明	是否必返	规范
riskSource	int	风险来源	Y	可能取值： `1000`：无风险 `1001`：文字风险 `1003`：音频语音风险
audioText	string	该片段识别的文字内容	N	该片段识别的文字内容
matchedLists	json_array	命中的客户自定义名单信息	N	仅在命中客户自定义名单时返回，详见matchedLists参数
riskSegments	json_array	高风险片段内容	N	检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在，详见riskSegments参数

其中，videoDetails的audioDetail的riskDetail的matchedLists数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
name	string	名单名称	N	名单名称
words	json_array	命中的这个名单中的敏感词信息	N	详见words参数

其中，videoDetails的audioDetail的riskDetail的matchedLists的words数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
word	string	命中的敏感词	N	命中的敏感词
position	int_array	敏感词所在位置	N	敏感词所在位置，下标从0开始计数

其中，videoDetails的audioDetail的riskDetail的riskSegments数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
segment	string	高风险内容片段	N	高风险内容片段
position	int_array	高风险内容片段所在位置	N	高风险内容片段所在位置，下标从0开始计数

其中，videoDetails的auxInfo具体参数如下：

参数名称	类型	参数说明	是否必返	规范
audioDuration	float	当前请求中的视频里的音频时长	Y	单位是秒，与计费数目一致。审核视频时，如果视频文件中音轨数据和视频时长不一致，计费时长以实际的音轨时长为准；例如可能会存在没有音轨的情况，计费时长就为0
frameCount	int	返回的视频截帧数量	Y	returnAllImg=0时为风险数量，returnAllImg=1时为全部数量
videoDuration	float	视频时长	Y	单位是秒

其中，auxInfo的内容如下：

参数名称	类型	参数说明	是否必返	规范
textNum	int	当前请求中的字符数	Y	当前请求中的字符数，与计费数目一致。字符数包括汉字、英文、标点符号、空格等
imgNum	int	当前请求中的图片数	Y	当前请求中的图片数，与计费数目一致。如遇动图会截取3帧；如遇长图会进行切分
audioNum	int	当前请求中的音频数	Y	当前请求中的音频数，与计费数目一致
videoNum	int	当前请求中的视频数	Y	当前请求中的视频数，与计费数目一致
passThrough	json_object	透传字段	N	客户传入的透传字段，数美内部不会对该字段进行识别处理，会随结果原样返回给用户
archiveManifestDetail	json_object	压缩包目录清单	N	仅当`fileFormat`为压缩包类型且公司已开启目录清单配置、解析成功时返回，详见archiveManifestDetail参数

其中，archiveManifestDetail为压缩包内文件目录树，根节点及各子节点字段如下：

参数名称	类型	参数说明	是否必返	规范
name	string	文件或目录名	Y	根节点为空字符串
type	string	节点类型	Y	`directory`：目录 `file`：文件
path	string	相对路径	N	相对压缩包根目录的路径，根节点可为空
url	string	对象存储地址	N	仅`type=file`时返回；公司已开启目录清单配置且上传成功时返回 URL，上传失败或未开启时可能为空或不返回
size	int	文件大小	N	单位：字节，仅`type=file`时返回
fileType	string	文件格式	N	仅`type=file`时返回。白名单内：取文件后缀大写，如`PDF`、`JPG`；白名单外有后缀：返回后缀大写（如`EXE`）；无后缀：返回`UNKNOWN`
category	string	文件分类	N	仅`type=file`时返回。白名单内：`document`/`image`/`audio`/`video`/`text`/`code`；白名单外或未识别：返回`other`（`other`类文件不参与内容识别送审，可能触发`archive unsupported file: {path}`）
md5	string	文件MD5	N	仅`type=file`时返回，32位小写hex；计算失败时可能为空字符串
children	json_array	子节点列表	N	仅`type=directory`时返回，元素结构同本表

示例#

回调模式示例#

以下示例仅展示字段结构，内容为虚构占位数据。

请求示例#

{
    "accessKey": "your_access_key",
    "appId": "your_app_id",
    "eventId": "document",
    "imgType": "POLITY_EROTIC_ADVERT",
    "txtType": "TEXTRISK",
    "audioType": "POLITY_EROTIC_ADVERT",
    "videoImgType": "POLITY_EROTIC_ADVERT",
    "videoAudioType": "POLITY_EROTIC_ADVERT",
    "callback": "http://www.xxx.top/callbackaddr",
    "data": {
        "url": "https://example.com/files/sample.pdf",
        "fileFormat": "PDF",
        "tokenId": "your_token_id",
        "lang": "zh",
        "acceptLang": "zh",
        "returnAllImg": 0,
        "returnAllText": 0,
        "returnAllVideoImg": 0,
        "returnAllVideoAudio": 0,
        "returnAllVideo": 0,
        "returnAllAudio": 0,
        "level": 2,
        "gender": "male",
        "nickname": "sample_user",
        "ip": "127.0.0.1",
        "deviceId": "your_device_id",
        "dataId": "your_data_id",
        "extra": {
            "room": "sample_room",
            "passThrough": {
                "customField": "customValue"
            }
        }
    }
}

请求即时响应示例#

{
    "code": 1100,
    "message": "success",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

回调返回示例#

{
    "code": 1100,
    "message": "success",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "riskLevel": "REVIEW",
    "textDetails": [
        {
            "allLabels": [
                {
                    "probability": 1,
                    "riskDescription": "广告:营销推广:营销关键词",
                    "riskDetail": {
                        "matchedLists": [
                            {
                                "name": "sample_list",
                                "words": [
                                    {
                                        "position": [10, 11],
                                        "word": "keyword"
                                    }
                                ]
                            }
                        ]
                    },
                    "riskLabel1": "ad",
                    "riskLabel2": "ad",
                    "riskLabel3": "ad",
                    "riskLevel": "REVIEW"
                }
            ],
            "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_1",
            "riskDescription": "广告:营销推广:营销关键词",
            "riskDetail": {
                "matchedLists": [
                    {
                        "name": "sample_list",
                        "words": [
                            {
                                "position": [10, 11],
                                "word": "keyword"
                            }
                        ]
                    }
                ]
            },
            "riskLabel1": "ad",
            "riskLabel2": "ad",
            "riskLabel3": "ad"
        }
    ],
    "imgDetails": [],
    "auxInfo": {
        "imgCount": 2,
        "textCount": 100
    }
}

压缩包检测示例#

以下示例基于 fileFormat=TAR_GZ 的压缩包检测请求。示例仅展示字段结构，内容为虚构占位数据。

请求示例#

{
    "accessKey": "your_access_key",
    "appId": "your_app_id",
    "eventId": "document",
    "imgType": "POLITY_EROTIC_ADVERT",
    "txtType": "TEXTRISK",
    "audioType": "POLITY_EROTIC_ADVERT",
    "videoImgType": "POLITY_EROTIC_ADVERT",
    "videoAudioType": "POLITY_EROTIC_ADVERT",
    "callback": "http://www.xxx.top/callbackaddr",
    "data": {
        "url": "https://example.com/files/sample.tar.gz",
        "fileFormat": "TAR_GZ",
        "tokenId": "your_token_id",
        "returnAllImg": 0,
        "returnAllText": 0,
        "returnAllAudio": 0
    }
}

请求即时响应示例#

{
    "code": 1100,
    "message": "success",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

回调返回示例#

{
    "code": 1100,
    "message": "success",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "riskLevel": "REJECT",
    "textDetails": [],
    "imgDetails": [],
    "audioDetails": [],
    "videoDetails": [],
    "auxInfo": {
        "textNum": 10,
        "imgNum": 2,
        "audioNum": 1,
        "videoNum": 1,
        "billingImgNum": 2,
        "billingAudioDuration": 10,
        "audioDuration": 20,
        "archiveManifestDetail": {
            "name": "",
            "type": "directory",
            "children": [
                {
                    "name": "dir_code",
                    "type": "directory",
                    "path": "dir_code",
                    "children": [
                        {
                            "name": "sample.java",
                            "type": "file",
                            "path": "dir_code/sample.java",
                            "url": "https://example.cos.region.com/path/archive_code_aaaaaaaa.java",
                            "size": 1024,
                            "fileType": "JAVA",
                            "category": "code",
                            "md5": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                        }
                    ]
                },
                {
                    "name": "dir_image",
                    "type": "directory",
                    "path": "dir_image",
                    "children": [
                        {
                            "name": "sample.jpg",
                            "type": "file",
                            "path": "dir_image/sample.jpg",
                            "url": "https://example.cos.region.com/path/archive_image_bbbbbbbb.jpg",
                            "size": 20480,
                            "fileType": "JPG",
                            "category": "image",
                            "md5": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
                        }
                    ]
                },
                {
                    "name": "dir_document",
                    "type": "directory",
                    "path": "dir_document",
                    "children": [
                        {
                            "name": "sample.pdf",
                            "type": "file",
                            "path": "dir_document/sample.pdf",
                            "url": "https://example.cos.region.com/path/archive_document_cccccccc.pdf",
                            "size": 102400,
                            "fileType": "PDF",
                            "category": "document",
                            "md5": "cccccccccccccccccccccccccccccccc"
                        }
                    ]
                },
                {
                    "name": "dir_video",
                    "type": "directory",
                    "path": "dir_video",
                    "children": [
                        {
                            "name": "sample.mp4",
                            "type": "file",
                            "path": "dir_video/sample.mp4",
                            "url": "https://example.cos.region.com/path/archive_video_dddddddd.mp4",
                            "size": 1048576,
                            "fileType": "MP4",
                            "category": "video",
                            "md5": "dddddddddddddddddddddddddddddddd"
                        }
                    ]
                },
                {
                    "name": "dir_audio",
                    "type": "directory",
                    "path": "dir_audio",
                    "children": [
                        {
                            "name": "sample.mp3",
                            "type": "file",
                            "path": "dir_audio/sample.mp3",
                            "url": "https://example.cos.region.com/path/archive_audio_eeeeeeee.mp3",
                            "size": 51200,
                            "fileType": "MP3",
                            "category": "audio",
                            "md5": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
                        },
                        {
                            "name": "sample2.mp3",
                            "type": "file",
                            "path": "dir_audio/sample2.mp3",
                            "url": "https://example.cos.region.com/path/archive_audio_ffffffff.mp3",
                            "size": 25600,
                            "fileType": "MP3",
                            "category": "audio",
                            "md5": "ffffffffffffffffffffffffffffffff"
                        }
                    ]
                }
            ]
        }
    },
    "resultType": 0,
    "finalResult": 1
}

说明：以上示例仅展示字段结构，内容为虚构占位数据。auxInfo.archiveManifestDetail 仅在公司已开启目录清单配置时返回；未开启时 auxInfo 不含该字段。回调中 textDetails/imgDetails 等字段结构与常规文档检测一致，此处省略。

异常回调返回示例（1904 / 1905）#

code 为 1904 或 1905 时，回调体仅包含 code、message、requestId，不含 riskLevel、textDetails 等业务字段。

{
    "code": 1904,
    "message": "get content has errors",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

{
    "code": 1904,
    "message": "archive corrupted",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

{
    "code": 1904,
    "message": "archive encrypted",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

{
    "code": 1904,
    "message": "archive unsupported file: inner/sample.exe",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

{
    "code": 1905,
    "message": "content format has errors",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

{
    "code": 1905,
    "message": "word count limit, quota: 10000, current: 15000",
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

结果查询接口#

用于异步队列、callback 回调或音视频分段回调等场景下，按检测接口返回的 requestId 主动查询终态审核结果（业务字段与上文回调返回结果一致）。

请求参数#

请求URL：#

集群	URL
北京	`http://api-article-bj.fengkongcloud.com/query_document/v4`
弗吉尼亚	`http://api-article-fjny.fengkongcloud.com/query_document/v4`
新加坡	`http://api-article-xjp.fengkongcloud.com/query_document/v4`

字符编码格式：#

UTF-8字符集编码

请求方法：#

POST

建议超时时长：#

15s

请求参数：#

放在HTTP Body中，采用Json格式，Body大小不可超过1M，具体参数如下：

请求参数名	类型	参数说明	是否必传	规范
accessKey	string	接口认证密钥	Y	与检测接口一致，由数美提供
requestIds	string_array	待查询的检测请求标识列表	Y	传入检测接口请求即时响应中的 `requestId`；单次最多20条，单条长度不超过128字符；重复项会去重

查询响应#

放在HTTP Body中，采用Json格式，具体参数如下：

参数名称	类型	参数说明	是否必返	规范
code	int	返回码	Y	`1100`：成功；`1902`：整单请求不合法。`1101`、`1903` 不出现在本字段，仅见于下文 `machineResult.code`
message	string	返回码描述	Y	与 code 对应
requestId	string	请求标识	Y	本次查询请求的标识
contents	json_array	查询结果列表	Y	与请求 `requestIds` 顺序一致，元素结构见下表

其中，contents 数组每个元素的内容如下：

参数名称	类型	参数说明	是否必返	规范
requestId	string	检测请求标识	Y	对应某项待查 `requestId`
machineResult	json_object	机审结果	Y	单项 `code`（与顶层 `code` 独立）：`1100` 终态成功，业务字段同上文回调返回结果；`1101` 无历史记录或仍在处理（message 为「请求正在处理」）；`1902` 历史表 `data` 无法解析为合法 JSON；`1903` 历史结果因数据过长写入降级记录（message 为「服务失败」，含 `detail` 等）。
humanResult	json_object	人审结果	N	有人审时返回
mergeResult	json_object	合并结果	N	优先展示策略合并结果，例如 `riskLevel`

示例#

请求示例#

{
    "accessKey": "your_access_key",
    "requestIds": ["xxx_detection_request_id"]
}

返回示例#

处理中（machineResult.code 为 1101）#

{
    "code": 1100,
    "message": "正常",
    "requestId": "query_req_001",
    "contents": [
        {
            "requestId": "xxx_detection_request_id",
            "machineResult": {
                "code": 1101,
                "message": "请求正在处理",
                "requestId": "xxx_detection_request_id"
            },
            "mergeResult": {
                "riskLevel": "xxx"
            }
        }
    ]
}

终态成功（machineResult.code 为 1100）#

{
  "code": 1100,
  "message": "正常",
  "requestId": "query_req_001",
  "contents": [
    {
      "requestId": "xxx_detection_request_id",
      "machineResult": {
        "code": 1100,
        "message": "成功",
        "requestId": "xxx_detection_request_id",
        "riskLevel": "xxx",
        "textDetails": [],
        "imgDetails": [],
        "audioDetails": [],
        "videoDetails": [],
        "auxInfo": {},
        "resultType": 0,
        "finalResult": 1
      },
      "mergeResult": {
        "riskLevel": "xxx"
      }
    }
  ]
}