电表与水表 OCR

从电表或水表的照片中读取读数，以数字返回。

POST/v3/store/smart-city/power-meter-and-water-meter/file

另有 1 个端点

试一试

• 价格1 IC每次请求
• 累计调用103.8K次

• v2.0
• 运行中

输入

输出POST /v3/store/smart-city/power-meter-and-water-meter/file

conf

0.59

infer_time(s)

0.06

label

220240

message

success

status

200

全部字段见“响应”一节其他端点：/base64 见请求

请求

curl -X POST https://api.iapp.co.th/v3/store/smart-city/power-meter-and-water-meter/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@meter.jpg"

响应

200成功。字段在"响应"一节说明。

{
    "conf": 0.59,
    "infer_time(s)": 0.06,
    "label": "220240",
    "message": "success",
    "status": 200
}

请求

以 multipart/form-data 发送到 /file，或将图像以 Base64 发送到 /base64。每读出一个读数 1 IC；无法读出表计读数的图像不扣费。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

表盘的清晰照片。

端点	接受
/v3/store/smart-city/power-meter-and-water-meter/file	文件
/v3/store/smart-city/power-meter-and-water-meter/base64	Base64 图像

旧路径 /meter-number-ocr、…/file 与 …/base64 仍可用，价格相同。

响应

读出读数时返回 HTTP 200：label 为读数（数字字符串），conf 为各位数字的平均置信度（0 到 1），infer_time(s) 为以秒计的处理耗时；响应另含 message 和 status。

无法从图像中读出表计读数时，API 返回 HTTP 422，且不扣费：

{
  "conf": 0,
  "error": "NO_READING_FOUND",
  "infer_time(s)": 0,
  "label": "",
  "message": "No meter reading could be read from the image.",
  "status": 422
}

状态码	含义	是否扣费
200	返回读数	1 IC
422	NO_READING_FOUND：无法从图像中读出表计读数	否
413	文件大于 2 MB	否
415	文件扩展名不是 jpg、jpeg、png 或 gif	否
461	请求中没有 file 字段	否
462	附加了多个文件	否

详情

实测

限制

• 支持圆形和方形表盘；清晰、正对表盘拍摄的照片识别效果最好。

数据处理

图像在内存中处理，响应返回后不保留。依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。

更新日志

日期	变更
2026 年 10 月 29 日	无法读出表计读数的图像现返回 HTTP 422（error 为 NO_READING_FOUND），且不扣费；此前返回 HTTP 200、label 为空并扣 1 IC。能读出读数的图像，返回结果与之前完全相同。