图像识别
HTTP方法:POST
请求地址
http://api.open.tuputech.com/v3/recognition/your_secretId
注:your_secretId 需替换为您的secretId,请联系我们为您开通secretId。
请求方法:
POST
请求头:
Content-Type: multipart/form-data
调用参数说明:
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
image | String or File | 是 | 1、支持传图片URL或者直接post图片文件,不过两者不能混在同一请求中; 2、支持多个image参数,也就是上传多个图片文件; 3、只支持对静态图像的处理,如:png、jpg、jpeg、tif、webp,不支持动态图像的处理,如:gif;如需识别请参考视频识别; 4、为了加快网络传输速度,图片大小必须在1M以内,且建议对图片进行压缩处理,等比压缩到[256, 512]之间。 |
timestamp | String | 是 | 当前的服务器的Unix时间戳,可以是毫秒或秒级。 |
nonce | String | 是 | 随机数,建议是[0-1]之间的小数,如:0.1527317095951506。 |
signature | String | 是 | 我们采用的数字证书签名算法是:"RSA-SHA256" ,签名输出类型是:"base64" ,具体步骤如下:1、所有参与签名的参数为:secretId,timestamp,nonce,用英文半角逗号“,”相连,得到sign_string; 2、利用您的私钥,使用算法 "RSA-SHA256" 签名,输出为 "base64" 格式,得到参数signature的值。点击管理公钥证书查看如何生成私钥,及如何上传您的公钥用于数字签名的认证;点击API SDK查看代码示例。 |
tag | String | 否 | 用于给图片或文本附加额外信息(比如:直播客户可能传房间号,或者主播ID信息)。方便后续根据tag搜索到相关的图片或文本。 1、支持多个tag参数,和image或text参数一一对应; 2、如果tag只有一个,或者tag数量少于image或text,缺省用最后一个tag补全(尾补全)。 |
referer | String | 否 | 图普根据图片url下载图片时,将其赋值给HTTP Header的Referer,用于图片防盗链。 |
task | String | 否 | 如果需要只执行接口下的某些审核的任务,可通过此参数指定,任务id的形式,如:54bcfc6c329af61034f7c2fc。不传该参数的话,执行该接口下的全部审核任务。 |
QPS限制
- 1秒最多允许请求10次;
- 1个请求最多携带10张图片;
如有特殊并发需求,请联系我们。
curl请求示例
单图:
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'image=@your_image_file_path_or_url' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'
多图:
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'image=@your_image_file_path_or_url_0' \
-F 'image=@your_image_file_path_or_url_1' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'
指定任务的curl请求示例
task指定只跑色情任务
curl -X POST --header 'Content-Type: multipart/form-data' \ -F 'image=@your_image_file_path_or_url' \ -F 'timestamp=1553249299' \ -F 'task=54bcfc6c329af61034f7c2fc' \ -F 'nonce=0.04708760756305974' \ -F 'signature=your_signature' \ 'http://api.open.tuputech.com/v3/recognition/your_secret_id'
task指定跑色情、暴恐任务
curl -X POST --header 'Content-Type: multipart/form-data' \ -F 'image=@your_image_file_path_or_url' \ -F 'timestamp=1553249299' \ -F 'task=54bcfc6c329af61034f7c2fc' \ -F 'task=5acb135cc40c6772b10ec73a' \ -F 'nonce=0.04708760756305974' \ -F 'signature=your_signature' \ 'http://api.open.tuputech.com/v3/recognition/your_secret_id'