文本异步任务结果查询接口
1. 接口介绍
查询 7 天内的文本异步识别任务状态及结果，可用于轮询任务结果。
提示
- 接口仅用于 文本异步识别任务
v3.1版本（即通过 文本异步接口 提交的任务）； - 单次查询仅支持查询一个
requestId对应的任务结果； - 任务结果默认保留 7 天，超过时长后将无法查询到详细结果。
2. 请求
2.1 请求地址
- v3.1（推荐）
| 区域 | 请求地址 |
|---|---|
| 国内 | https://api.text.tuputech.com/v3.1/recognition/text/result/<secretId> |
| 国外 | https://api-oversea.text.tuputech.com/v3.1/recognition/text/result/<secretId> |
提示
<secretId> 需替换为您的应用 SID，请联系客户经理为您开通及配置。关于 SID
详见 常见问题（FAQ）。
2.2 请求方法
POST
2.3 请求头
| 请求头名称 | 取值 | 是否必需 | 示例 | 说明 |
|---|---|---|---|---|
Content-Type | application/json | 是 | Content-Type: application/json | 请求数据类型为 JSON |
X-API-Key | <API Key> | 是 | X-API-Key: <API Key> | API Key 用于接口鉴权。请访问控制台 - 数字证书 获取 API Key |
2.4 超时时间及异常处理
建议配置超时时间 1 秒，在 HTTP 响应状态码非 200 或业务状态码不为 0 时进行重试。
2.5 请求参数说明 🔥
- v3.1（推荐）
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
requestId | String | 是 | 文本异步任务 ID（由 文本异步接口 同步响应返回的 requestId 字段） |
timestamp | Int | 否 | 当前服务器的 Unix 时间戳。 当前已废弃，仅保持兼容（采用该鉴权方式的调用不受影响）。新接入请使用 API Key 接口鉴权 |
nonce | Float | 否 | 随机数（建议使用 Unix 时间戳或若干位随机整数）。 当前已废弃，仅保持兼容（采用该鉴权方式的调用不受影响）。新接入请使用 API Key 接口鉴权 |
signature | String | 否 |
|
2.6 请求示例
- v3.1（推荐）
{
"requestId": "<requestId>"
}
3. 同步响应
3.1 响应参数说明 🔥🔥
| 参数名称 | 类型 | 说明 |
|---|---|---|
signature | String | 同步响应或回调请求签名，由图普使用私钥签名，在需要时，您可以通过 图普公钥
进行验签以确保此响应内容来自图普（与您调用接口时使用的公私钥不同）。验签步骤：
|
json | String | 同步响应或回调请求经过 JSON 转义后的字符串，需进一步解析得到业务数据。
|
JSON 参数说明
- v3.1（推荐）
| 参数名称 | 类型 | 是否必有 | 说明 |
|---|---|---|---|
code | Int | 是 | 状态码，详见 业务状态码。通常返回：0：任务处理完成；29：任务不存在或结果已过期；30：任务正在排队；31：任务正在处理；32：任务已被取消；33：任务处理失败 |
message | String | 是 | 状态信息 |
requestId | String | 是 | 任务 ID |
suggestion | Int | 否 | 汇总结果，整体的通过/拒绝情况，详见 审核场景汇总结果说明 |
riskType | Int | 否 | 汇总结果，整体的风险类型，详见 审核场景汇总结果说明 |
customInfo | Object<String, Any> | 否 | 透传的自定义信息，请求参数中的 customInfo |
nonce | Float | 是 | 随机数（建议使用 Unix 时间戳或若干位随机整数） |
timestamp | Int | 是 | 当前服务器的 Unix 时间戳 |
<任务 ID> | Object | 否 | 识别任务的具体结果。每个识别任务会有 全局固定不变 的 taskId 和对应数据结构，详见 具体任务识别结果回调 |
3.2 响应示例
- v3.1（推荐）
{
"57c4036c557603652aeeb222": {
"texts": [
{
"content": "<文本内容>",
"details": [
{
"endPos": 20,
"hint": "<hint>",
"keyword": "<keyword>",
"mainLabel": 2,
"startPos": 18
},
{
"endPos": 142,
"hint": "<hint>",
"keyword": "<keyword>",
"mainLabel": 2,
"startPos": 139,
"subLabel": "<subLabel>"
}
],
"label": 2,
"rate": 1,
"review": false
}
]
},
"code": 0,
"customInfo": {
"contentId": "<contentId>"
},
"message": "success",
"nonce": 1685000000,
"requestId": "<requestId>",
"riskType": 2,
"suggestion": 1,
"timestamp": 1685000000
}
4. 更新日志
| 日期 | 说明 |
|---|---|
| 2026-02-25 | 新增 v3.1 文本异步查询接口文档 |