二维码识别及搜索
1. 任务简介
1.1 任务 ID
603f0250412c974c621d5c88
提示
任务 ID 全局固定且不变,建议客户将其定义为代码常量。
1.2 能力介绍
识别图片中是否含有二维码,当含有二维码时,解析二维码包含的文字信息/指向的链接地址。 用户可以配置文本黑/白名单,对应进行管控,通过或拒绝相关文字信息/链接地址。
1.3 使用场景
场景 | 说明 |
---|---|
游戏社交 | 管控用户的聊天或动态图片,避免恶意引流到其他平台 |
直播/融媒体 | 管控相关内容,避免观众被引导扫码后打开非法链接,规避潜在的风险 |
2. 请求参数
图片接口公共请求参数详见:图片同步识别接口,图片异步识别接口
视频接口公共请求参数详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3. 返回结果
3.1 公共返回结果
图片接口公共返回结果详见:图片同步识别接口,图片异步识别接口
视频接口公共返回结果详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3.2 任务返回结果 🎯
- 图片接口
- 视频文件接口(v3.1)
- 视频流接口(v3.1)
- 文档接口(v3.1)
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果,详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
name | String | 是 | 如果上传的 image 参数是 url,则该值是图片 url;如果是以图片文件上传,则该值为文件名 |
label | Number | 是 | 识别分类( -1 表示识别失败),详见 任务返回标签说明 |
rate | Float | 是 | 分类得分,范围 [0.0, 1.0], 值越高机器对判定结果越有把握 |
review | Boolean | 是 | 是否需要复审,true :需要,false :不需要 |
objects | Array | 是 | 检测出来的所有物体,详见 Object 参数说明 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
location | Array | 是 | 物体方框坐标以图片左上角为原点,分别是[左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式。小语种文字识别不返回该项。 |
degree | Float | 是 | 文字的旋转角度,取值范围是 [-180, 180],正表示顺时针,负表示逆时针 |
text | String | 是 | 识别到的文本信息 |
scores | Float | 是 | 文本检测得分,分数越高,识别出来的结果越准确,介于 0-1 的浮点数 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array | 否 | 每张图片的识别结果,在数组为空时该字段省略。详见 FileResult 参数说明 |
label | Int | 是 | 图片汇总后的识别分类( -1 表示识别失败),详见 任务返回标签说明 |
review | Boolean | 是 | 图片汇总后的结果是否需要复审 |
maximums | Array | 是 | 图片汇总后,识别分类及对应的最大得分,详见 Maximum 参数说明 |
statistics | Array | 是 | 图片汇总后,识别分类及对应的图片数量,详见 Statistic 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
name | String | 是 | 视频截图文件名称 |
label | Number | 是 | 识别分类( -1 表示识别失败),详见 任务返回标签说明 |
rate | Float | 是 | 分类得分,范围 [0.0, 1.0], 值越高机器对判定结果越有把握 |
review | Boolean | 是 | 是否需要复审,true :需要,false :不需要 |
objects | Array | 是 | 检测出来的所有物体,详见 Object 参数说明 |
url | String | 是 | 视频截图文件链接,有效期 7 天 |
second | Float | 是 | 视频截图时间点,表示在第 N 秒截取了该图片。 1. 对于视频流,值为开始截图后的相对时间点 |
Maximum 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 识别分类 |
max | Float | 是 | 对应识别分类的最大得分 |
Statistic 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 识别分类 |
count | Int | 是 | 对应识别分类的图片数量 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
location | Array | 是 | 物体方框坐标以图片左上角为原点,分别是[左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式。小语种文字识别不返回该项。 |
degree | Float | 是 | 文字的旋转角度,取值范围是 [-180, 180],正表示顺时针,负表示逆时针 |
text | String | 是 | 识别到的文本信息 |
scores | Float | 是 | 文本检测得分,分数越高,识别出来的结果越准确,介于 0-1 的浮点数 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果,详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
name | String | 是 | 视频截图文件名称 |
label | Number | 是 | 识别分类( -1 表示识别失败),详见 任务返回标签说明 |
rate | Float | 是 | 分类得分,范围 [0.0, 1.0], 值越高机器对判定结果越有把握 |
review | Boolean | 是 | 是否需要复审,true :需要,false :不需要 |
objects | Array | 是 | 检测出来的所有物体,详见 Object 参数说明 |
url | String | 是 | 视频截图文件链接,有效期 7 天 |
second | Float | 是 | 视频截图时间点,表示在第 N 秒截取了该图片。 1. 对于视频流,值为开始截图后的相对时间点 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
location | Array | 是 | 物体方框坐标以图片左上角为原点,分别是[左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式。小语种文字识别不返回该项。 |
degree | Float | 是 | 文字的旋转角度,取值范围是 [-180, 180],正表示顺时针,负表示逆时针 |
text | String | 是 | 识别到的文本信息 |
scores | Float | 是 | 文本检测得分,分数越高,识别出来的结果越准确,介于 0-1 的浮点数 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果,详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
name | String | 是 | 图片名称,根据所在页及图片索引生成,用以唯一标识文档中的图片 |
label | Number | 是 | 识别分类( -1 表示识别失败),详见 任务返回标签说明 |
rate | Float | 是 | 分类得分,范围 [0.0, 1.0], 值越高机器对判定结果越有把握 |
review | Boolean | 是 | 是否需要复审,true :需要,false :不需要 |
objects | Array | 是 | 检测出来的所有物体,详见 Object 参数说明 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
location | Array | 是 | 物体方框坐标以图片左上角为原点,分别是[左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式。小语种文字识别不返回该项。 |
degree | Float | 是 | 文字的旋转角度,取值范围是 [-180, 180],正表示顺时针,负表示逆时针 |
text | String | 是 | 识别到的文本信息 |
scores | Float | 是 | 文本检测得分,分数越高,识别出来的结果越准确,介于 0-1 的浮点数 |
3.3 任务返回标签说明 🎯🎯
label 值 | 说明 |
---|---|
0 | 无二维码 |
1 | 通过(匹配到正常标签文本名单,或未匹配到文本名单) |
2 | 拒绝(匹配到非正常标签文本名单) |
3.4 任务结果示例
- 图片接口
- 视频文件接口(v3.1)
- 视频流接口(v3.1)
- 文档接口(v3.1)
{
"603f0250412c974c621d5c88": {
"fileList": [
{
"name": "test1.png",
"label": 2,
"rate": 1,
"review": false,
"objects": [
{
"location": [
[
0.1356382978723404,
0.265625
],
[
0.8643617021276596,
0.265625
],
[
0.8643617021276596,
0.802734375
],
[
0.1356382978723404,
0.802734375
]
],
"text": "test-text",
"scores": 1,
"degree": 0
}
]
}
]
}
}
{
"603f0250412c974c621d5c88": {
"fileList": [
{
"name": "82ffc7248926472d9ea83c27084fdcff-11",
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2023-12-08/16-7/82ffc7248926472d9ea83c27084fdcff/1702023783.1158757082902140151.jpeg",
"second": 29.999999105930353,
"label": 2,
"rate": 1,
"review": false,
"objects": [
{
"location": [
[
0.1356382978723404,
0.265625
],
[
0.8643617021276596,
0.265625
],
[
0.8643617021276596,
0.802734375
],
[
0.1356382978723404,
0.802734375
]
],
"text": "test-text",
"scores": 1,
"degree": 0
}
]
}
]
}
}
{
"603f0250412c974c621d5c88": {
"fileList": [
{
"name": "82ffc7248926472d9ea83c27084fdcff-11",
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2023-12-08/16-7/82ffc7248926472d9ea83c27084fdcff/1702023783.1158757082902140151.jpeg",
"second": 29.999999105930353,
"label": 2,
"rate": 1,
"review": false,
"objects": [
{
"location": [
[
0.1356382978723404,
0.265625
],
[
0.8643617021276596,
0.265625
],
[
0.8643617021276596,
0.802734375
],
[
0.1356382978723404,
0.802734375
]
],
"text": "test-text",
"scores": 1,
"degree": 0
}
]
}
]
}
}
{
"603f0250412c974c621d5c88": {
"fileList": [
{
"name": "82ffc7248926472d9ea83c27084fdcff-1-1",
"label": 2,
"rate": 1,
"review": false,
"objects": [
{
"location": [
[
0.1356382978723404,
0.265625
],
[
0.8643617021276596,
0.265625
],
[
0.8643617021276596,
0.802734375
],
[
0.1356382978723404,
0.802734375
]
],
"text": "test-text",
"scores": 1,
"degree": 0
}
]
}
]
}
}