文本审核结果反馈
1. 接口介绍
- 该接口可以反馈文本审核任务的结果,客户通过指定任务的机审结果和人审结果来反馈。
我们会根据反馈的标注结果与原机审结果进行对比分析,以更好地对我们的模型效果进行优化迭代。
经过数据接口回流的数据,图普侧的人审工作人员会在
2
个工作日内处理完毕,人审确定是模型误判或者漏判问题的,我们会统一收集这些badcase
进行月度模型的优化,涉及到模型优化迭代需要确认的具体信息我们会第一时间跟您联系。
以同步文本审核为例,业务流程如下:
2. 请求
2.1 请求地址
区域 | 请求地址 |
---|---|
国内 | https://api.open.tuputech.com/v3/feedback/text/<secretId> |
提示
<secretId>
需替换为您的应用 SID
,请联系客户经理为您开通及配置。关于 SID
详见 常见问题(FAQ)。
2.2 请求方法
POST
2.3 请求头
Content-Type: application/json
2.4 超时时间及异常处理
建议配置超时时间 10
秒,在 HTTP 响应状态码非 200
或业务状态码不为 0
时进行重试。
提示
- 接口并发限制:每秒请求数不超过 10 次;
2.5 请求参数说明 🔥🔥🔥
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
timestamp | String | 是 | 当前服务器的 Unix 时间戳,可以是毫秒或秒级。 |
nonce | Number | 是 | 随机数,建议是 [0-10000] 之间的整数,如:1345 。 |
signature | Number | 是 |
|
texts | Array<Text> | 是 | 回流数据,详见 Text 参数说明 |
Text 参数说明
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
label | String/Number | 是 | 图普接口返回的原始机审标签。
|
manualLabel | String/Number | 是 | 人工判断应该识别为的标签。
|
content | String | 是 | 文本内容 |
thirdPartyLabel | String/Number | 否 | 其他(第三方)识别出的结果标签。 |
2.6 请求示例 🔥🔥
{
"timestamp": 1685000000,
"nonce": 1685000000,
"signature": "<signature>",
"images": [
{
"label": "0",
"manualLabel": "2",
"url": "<url>"
}
]
}
3. 响应
3.1 响应参数说明 🔥
参数名称 | 类型 | 说明 |
---|---|---|
signature | String | 同步响应或回调请求签名,由图普使用私钥签名,在需要时,您可以通过 图普公钥 进行验签以确保此响应内容来自图普(与您调用接口时使用的公私钥不同)。验签步骤:
|
json | String | 同步响应或回调请求经过 JSON 转义后的字符串,需进一步解析得到业务数据。
|
JSON 参数说明
参数名称 | 类型 | 是否可能为空 | 说明 |
---|---|---|---|
code | Number | 否 | 请求的状态码,参考服务业务状态码解析 |
message | String | 否 | 请求的状态信息 |
timestamp | Number | 否 | 当前服务器的 Unix 时间戳 |
nonce | Number | 否 | 随机数 |
result | Object | 否 | 回流结果,见 result 参数说明 |
result 参数说明
参数名称 | 类型 | 是否可能为空 | 说明 |
---|---|---|---|
total | Number | 否 | 成功回流的数据数目 |
3.2 响应示例
{
"code": 0,
"message": "success",
"result": {
"total": 10
},
"timestamp": 1685000000,
"nonce": 1685000000
}
3.3 解析响应伪代码
// 1. 解析 body 的 json 字段
res = JSON.parse(body.json)
// 2. 是否操作成功,否的话进入错误处理流程
if (res.code != 0) {
handleError(res)
return
}
// 3. 获取回流结果
handler(res.result)
return
}
4. 更新日志
日期 | 说明 |
---|---|
2024-08-16 | 增加业务流程图, 优化文档结构 |