固定接口
所有项目共用；taskid 只会在成功扣点或专项成功的识别响应中返回，有效期 60 秒。
| 接口 | 方式 | 地址 | 参数 | 返回 | 说明 |
|---|---|---|---|---|---|
| 识别提交 | POST | https://api.tmocr.com/post | appkey、itemid、本项目参数 | success、code、message、data、time、taskid | time 为服务端耗时；成功扣点或专项成功响应返回 taskid。 |
| 余额查询 | POST | https://api.tmocr.com/balance | appkey | success、code、message、data、time | 按 appkey 查询可用点数及其折算余额。 |
| 结果错误上报 | POST | https://api.tmocr.com/report | appkey、taskid、reason(可选) | success、code、message、data、time | 成功响应后 60 秒内提交；重复提交不会重复退点。 |
请求参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| appkey | string | 必填 | 用户密钥。 | YOUR_APPKEY |
| itemid | string | 必填 | 项目 ID。 | 1001 |
| developerKey | string | 选填 | 开发者标识，选填。 | YOUR_DEVELOPER_KEY |
| main | base64 string | 必填 | 主图 base64。 | BASE64_IMAGE_DATA |
| title | array<string> | 必填 | 副图或关联文本。 | ["BASE64_IMAGE_DATA_A","BASE64_IMAGE_DATA_B"] |
对接接口
| 对接地址 | https://api.tmocr.com/post |
|---|---|
| 请求方式 | POST |
| 内容类型 | JSON / 表单 / multipart |
| 项目 ID | 1001 |
| 响应格式 | JSON |
| 在线测试 | 登录后可用 |
在线测试
可测试
登录后可直接上传图片进行扣费测试。登录后测试
测试参数
ItemID 1001
主图
base64 string
必填
主图 base64。
上传后会在这里显示图片预览。
标题图片
array<string>
必填
副图或关联文本。
上传后会在这里显示图片预览。
请求 JSON
{
"appkey": "LOGIN_REQUIRED",
"itemid": "1001",
"main": "",
"title": []
}结果图片标注
坐标、点位、框选或滑块位移结果会叠加在本次上传的图片上。
当前响应没有可叠加的坐标或框选结果
返回值已保留，当前项目结果更适合文本或表格查看。
当前记录没有可展示的公开结果。
JSON 实际结果
{
"message": "提交测试后显示实际返回结果。"
}代码示例
按语言复制调用示例。
curl -X POST "https://api.tmocr.com/post" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY",
"itemid": "1001",
"developerKey": "YOUR_DEVELOPER_KEY",
"main": "BASE64_IMAGE_DATA",
"title": [
"BASE64_IMAGE_DATA_A",
"BASE64_IMAGE_DATA_B"
]
}'余额查询示例
按 appkey 查询可用点数及折算余额。
curl -X POST "https://api.tmocr.com/balance" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY"
}'结果错误上报示例
仅成功扣点响应会返回 taskid；如结果不正确，可在 60 秒内上报。
curl -X POST "https://api.tmocr.com/report" \
-H "Content-Type: application/json" \
-d '{
"appkey": "YOUR_APPKEY",
"taskid": "TXAbCdEfGhIjKl",
"reason": "识别结果不正确"
}'响应示例
平台响应格式示例。
成功响应
HTTP 200
{
"success": true,
"code": "OK",
"message": "识别成功",
"data": "33,104|68,31|138,109",
"time": "123ms",
"taskid": "TXAbCdEfGhIjKl"
}失败响应
回放方式：故意省略必填字段 `main`
HTTP 400
{
"success": false,
"code": "RECOGNITION_FAILED",
"message": "Missing parameters [image, file]",
"data": "",
"time": "8ms"
}