图片违规内容检测接口

开始使用前，请先创建应用，申请UGC内容安全审核，并成功完成审批。

注意

待检测图片需要满足以下要求：

• 图片链接支持以下协议：HTTP和HTTPS。
• 图片支持以下格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
• 图片大小限制为10MB以内（适用于同步和异步调用）。
• 图片下载时间限制为3秒内，如果下载时间超过3秒，返回下载超时。
• 图片像素建议不低于256*256，像素过低可能会影响识别效果。
• 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠。

请求

POST https://apigate.glodon.com/ugc/api/v1/scan/image

header参数

参数名	必选	类型	描述
Authorization	是	字符串	Bearer app_access_token. 注：该 access_token 是应用级别
Content-Type	是	字符串	application/json

body参数

参数名	必选	参数类型	参数含义
url	是	字符串	需检测的图片地址
client_appkey	否	字符串	上层业务调用对应的appkey
client_name	否	字符串	上层调用业务线名称

API请求示例

返回参数

名称	类型	是否必须	描述
code	字符串	是	请求成功为0，否则为error code
message	字符串	是	请求成功为success，否则为错误描述信息
globalSuggestion	字符串	是	本次检测结果，取值： pass：文本正常，可以直接放行 review：文本需要进一步人工审核（只要有一个suggestion为review，即为review） block：文本违规，可以直接删除或者限制公开（只要有一个suggestion为block，即为block）
dataId	字符串	否	检测对象对应的数据ID
taskId	字符串	是	本次检测任务的ID
scene	字符串	是	默认同时检测以下场景，取值： porn：色情 terrorism：暴恐
suggestion	字符串	是	每个scene的检测结果，可作为规则调整优化的参考，取值： pass：图片正常或者未识别出目标对象，无需进行其余操作 review：检测结果不确定或者识别出目标对象，需要进行人工审核 block：图片违规，建议直接删除或者限制公开
rate	浮点数	是	结果属于当前分类的概率，取值范围：0.00-100.00，值越高，表示越有可能属于当前分类
url	字符串	是	检测的图片地址

场景scene与label对应关系

场景	描述	scene	label
图片智能鉴黄	识别图片中的色情内容	porn	normal：正常图片，无色情内容 sexy：性感图片 porn：色情图片
图片暴恐涉政识别	识别图片中的暴恐涉政内容	terrorism	normal：正常图片 bloody：血腥 explosion：爆炸烟光 outfit：特殊装束 logo：特殊标识 weapon：武器 politics：涉政 violence：打斗 crowd：聚众 parade：游行 carcrash：车祸现场 flag：旗帜 location：地标 others：其他

返回结果示例

下一步操作

依据 globalSuggestion 对检测对象进行放行、二次审核或直接删除。根据label参数的返回值判断风险类型。

附：错误码说明

code	msg	description
0	success	请求成功。
280	PROCESSING	任务正在执行中，建议您等待一段时间（例如5s）后再查询结果。
400	BAD_REQUEST	请求参数不正确，请仔细检查请求参数。
401	NOT_ALLOWED	图片、视频、语音链接地址不安全。
403	FORBIDDEN	图片、视频、语音链接无法访问，请确认公网是否可访问，并且无防盗链策略。
404	NOT_FOUND	待检测内容未找到，图片、视频、语音内容无法下载导致，请确认内容可通过公网访问到。
480	DOWNLOAD_FAILED	下载失败，请确认待检测内容的大小、分辨率（如果有）在API的限制范围内。
500	GENERAL_ERROR	服务端临时出错，请重试。
580	DB_FAILED	数据库操作失败，请重试。
581	TIMEOUT	超时，请重试。
585	CACHE_FAILED	缓存出错，请重试。
586	ALGO_FAILED	算法出错。
587	MQ_FAILED	中间件出错。
588	EXCEED_QUOTA	请求频率超出配额。
589	TOO_LARGE	待检测内容过大，请确保检测的内容在API的限制范围内，请重试。
590	BAD_FORMAT	待检测内容格式错误，请确保检测的内容在API的限制范围内。
591	CONNECTION_POOL_FULL	连接池满。
592	DOWNLOAD_TIMEOUT	下载超时，下载时间限制为3s，请确保检测的内容大小在API的限制范围内。
594	EXPIRED	任务过期，如taskId过期。
595	CATCH_FRAME_FAILED	截帧失败。
596	PERMISSION_DENY	账号未授权、账号欠费、账号未开通、账号被禁等。