异步批量请求#
用于异步上传批量图片并进行检测,通过查询接口查询结果。可协助您识别图片中的涉政、色情、广告、暴恐等风险；同时可结合您的业务场景，识别人脸、LOGO、动植物等内容。
接口说明#
批量检测接口，调用审核后，可通过查询的方式得到审核结果。
接口要求#
通信协议：http或https协议 请求方法：POST方法 字符编码：utf-8 参数格式：所有请求参数和返回参数都是采用json格式
图片要求#
图片类型：URL、BASE64 图片格式：jpg，jpeg，png，webp，gif，tiff，tif，heif 图片像素：建议图片像素不小于`256*256`，目前支持`20*20`~`6000*6000`范围的分辨率图片 图片大小：图片大小限制30M。 截帧说明：长图默认不切分，开通可联系数美，计费会增多。gif图按照传入参数决定切分张数
审核时间#
建议超时时间：5秒。 内部检测逻辑：图片检测接口的响应时间依赖图片的下载时间，请保证被检测图片所在的存储服务稳定可靠。数美下载图片时的连接超时时间是2秒，读取超时时间是3秒（如失败会重试一次）。批量图片服务内部分两次并行处理，内部平均处理时间在500毫秒左右，具体时长和请求type、图片大小相关。
历史版本#
历史版本请求#
请求地址#
请求参数#
| 参数名称 | 类型 | 是否必传 | 最大长度 | 参数说明 |
|---|---|---|---|---|
| accessKey | string | 是 | 20 | 公司密钥。用于权限认证，开通服务时由数美提供 |
| eventId | string | 是 | 64 | 事件标识。需要与数美约定好取值。 |
| appId | string | 是 | 64 | 应用标识。此字段强校验，需要提前与数美约定好取值。 |
| type | string | 否 | 64 | 需要识别的风险类型。type与businessType至少传一个, 可选值： POLITY ：涉政识别 EROTIC ：色情&性感违规识别 VIOLENT ：暴恐&违禁识别 QRCODE ：二维码识别 ADVERT ：广告识别 IMGTEXTRISK ：图片文字违规识别（如需要识别图片里文字的违规内容，务必传入图片文字违规识别功能） 如果需要识别多个功能，通过下划线连接，如 POLITY_QRCODE_ADVERT 用于涉政、二维码和广告组合识别 |
| businessType | string | 否 | 128 | 需要识别的业务类型。businessType与type至少传一个，可选值见业务标签类型 |
| data | object | 是 | - | 请求的数据内容 |
| tokenId | string | 是 | 64 | 用户账号标识。建议传入用户ID，可用于灌水、广告等行为维度的风险识别。 |
| imgs | array | 是 | - | 要检测的图片数组，要求数组长度在12以内 |
| btId | string | 是 | 30 | 客户侧请求唯一标识 |
| img | string | 是 | 1024 | 要检测的图片，可使用图片的base64编码或者图片的url链接 |
| imgCompareBase | string | 否 | 1024 | 要检测比对的基准图片。请求参数businessType字段包含标签`FACECOMPARE`时存在 可使用base64编码的图片数据或者图片的url链接 支持格式： jpg，jpeg，png，webp，gif，tiff，tif，heif 建议图片像素不小于256*256，图片大小最大10MB 基准图暂时不支持长图和动图格式 |
| dataId | string | 否 | 128 | 客户自定义数据Id。可以用于数美saas后台检索 |
| deviceId | string | 否 | 128 | 数美设备指纹标识。由数美SDK生成，用于用户行为分析。 |
| gender | string | 否 | - | 用户性别，建议值： male：男性 female：女性 ambiguity：性别不明 |
| interval | int32 | 否 | - | 动图截帧频率。动图检测专用，默认值为1。每interval张图片抽取一张进行检测。 当interval*maxFrame小于该图片所包含的图片数量时，截帧间隔会自动修改为该图片所包含的图片数/maxFrame，以提高整体检测效果。 |
| ip | string | 否 | 64 | 客户端公网IP地址。该参数用于IP维度的用户行为分析。 |
| lang | string | 否 | - | 语言类型。当type中包含`IMGTEXTRISK`时，可指定对应检测语种类型（默认为中文），可选值：： zh：中文 en：英文 ar：阿拉伯语 |
| level | int32 | 否 | - | 用户等级，针对不同等级的用户可配置不同拦截策略。可选值：0：最低级用户，典型如新注册、完全不活跃或等级为0的用户等; 1：较低级用户，典型如低活跃或低等级用户等； 2：中等级用户，典型如具备一定活跃或等级中等的用户等； 3：较高级用户，典型如高活跃或高等级用户等； 4：最高级用户，典型如付费用户、VIP用户等 |
| maxFrame | int32 | 否 | - | 动图的最大截帧数量。截取gif等动图帧数，最大为20帧，默认为3帧，计费按照实际截帧数量计费，如默认为截取3帧时按照3帧进行计费 |
| receiveTokenId | string | 否 | 64 | 消息接收者的tokenId由数字、字母、下划线、短杠组成的长度小于等于64位的字符串 |
| extra | object | 否 | - | 辅助参数。用于辅助检测的相关信息 |
| room | string | 否 | 64 | 直播间/游戏房间编号，可针对单个房间制定不同的策略 |
| passThrough | object | 否 | 1024 | 客户传入透传字段。数美内部不会对该字段进行识别处理，随结果返回给用户。 |
