Water Bill OCR

Response Definition

HTTP Status

Code

Message

Description

200

OCR success.

206

partial_content

Some page of request is invalid

400

bad_request

Image too small

Image base 64 might be too small to process please check resolution of your image

400

bad_request

Fail to process table extraction

Fail to process table on document

413

too_large_request

Request size is too large; the input size must be less than 10 MB

Image base 64 might be too large to process please check the file size must not greater than 10 MB

500

1000

Internal server error

some error occurred in server side

Extract water bill information

POST https://apis.aigen.online/aiscript/utility-waterbill/v2

Request Body

Name

Type

Description

image*

String

Base64 image encoded string

{'status': 'success',
 'error': [],
 'data': [{'acc_no': {'value': '79898938',
    'bboxes': [[[442, 499], [699, 499], [699, 545], [442, 545]]],
    'bboxes_norm': [[[0.2597, 0.1529],
      [0.4107, 0.1529],
      [0.4107, 0.167],
      [0.2597, 0.167]]],
    'confidence': 0.9982},
   'billing_issue_date': {'value': '01/65',
    'bboxes': [[[1492, 218], [1599, 218], [1599, 257], [1492, 257]]],
    'bboxes_norm': [[[0.8766, 0.0668],
      [0.9395, 0.0668],
      [0.9395, 0.0787],
      [0.8766, 0.0787]]],
    'confidence': 0.9982},
   'branch_id': {'value': '56-05',
    'bboxes': [[[182, 505], [338, 505], [338, 545], [182, 545]]],
    'bboxes_norm': [[[0.1069, 0.1547],
      [0.1986, 0.1547],
      [0.1986, 0.167],
      [0.1069, 0.167]]],
    'confidence': 0.9982},
   'customer_name': {'value': 'นายธีระยุทธ แสงวุธ',
    'bboxes': [[[76, 2598], [650, 2598], [650, 2699], [76, 2699]]],
    'bboxes_norm': [[[0.0447, 0.796],
      [0.3819, 0.796],
      [0.3819, 0.8269],
      [0.0447, 0.8269]]],
    'confidence': 0.9698},
   'deduction_price': {'value': '0.00',
    'bboxes': [[[1067, 953], [1176, 953], [1176, 995], [1067, 995]]],
    'bboxes_norm': [[[0.6269, 0.292],
      [0.691, 0.292],
      [0.691, 0.3048],
      [0.6269, 0.3048]]],
    'confidence': 0.9982},
   'home_address': {'value': '89/54 หมู่ 10 มบ.อินดีบางใหญ่ (2) ถ.เทิดพระเกียรติ ตำบลบางแม่นาง อำเภอบางใหญ่ นนทบุรี',
    'bboxes': [[[73, 2656], [1193, 2656], [1193, 2754], [73, 2754]],
     [[246, 2738], [997, 2738], [997, 2816], [246, 2816]]],
    'bboxes_norm': [[[0.0429, 0.8137],
      [0.7009, 0.8137],
      [0.7009, 0.8438],
      [0.0429, 0.8438]],
     [[0.1445, 0.8388], [0.5858, 0.8388], [0.5858, 0.8627], [0.1445, 0.8627]]],
    'confidence': 0.9662},
   'invoice_no': {'value': '005619-2',
    'bboxes': [[[1072, 492], [1249, 492], [1249, 538], [1072, 538]]],
    'bboxes_norm': [[[0.6298, 0.1507],
      [0.7338, 0.1507],
      [0.7338, 0.1648],
      [0.6298, 0.1648]]],
    'confidence': 0.9982},
   'monthly_service_price': {'value': '25.00',
    'bboxes': [[[1031, 1028], [1179, 1028], [1179, 1073], [1031, 1073]]],
    'bboxes_norm': [[[0.6058, 0.315],
      [0.6927, 0.315],
      [0.6927, 0.3287],
      [0.6058, 0.3287]]],
    'confidence': 0.9981},
   'overdue_number': {'value': '0',
    'bboxes': [[[399, 1315], [641, 1315], [641, 1390], [399, 1390]]],
    'bboxes_norm': [[[0.2344, 0.4029],
      [0.3766, 0.4029],
      [0.3766, 0.4259],
      [0.2344, 0.4259]]],
    'confidence': 0.9982},
   'overdue_price': {'value': '0.00',
    'bboxes': [[[1070, 1325], [1187, 1325], [1187, 1370], [1070, 1370]]],
    'bboxes_norm': [[[0.6287, 0.4059],
      [0.6974, 0.4059],
      [0.6974, 0.4197],
      [0.6287, 0.4197]]],
    'confidence': 0.9982},
   'payment_due_date': {'value': '09/0T/65',
    'bboxes': [[[941, 1550], [1193, 1550], [1193, 1596], [941, 1596]]],
    'bboxes_norm': [[[0.5529, 0.4749],
      [0.7009, 0.4749],
      [0.7009, 0.489],
      [0.5529, 0.489]]],
    'confidence': 0.9175},
   'total_monthly_price': {'value': '211.86',
    'bboxes': [[[1004, 1237], [1181, 1237], [1181, 1282], [1004, 1282]]],
    'bboxes_norm': [[[0.5899, 0.379],
      [0.6939, 0.379],
      [0.6939, 0.3928],
      [0.5899, 0.3928]]],
    'confidence': 0.9981},
   'total_price': {'value': '211.86',
    'bboxes': [[[878, 1429], [1187, 1429], [1187, 1475], [878, 1475]]],
    'bboxes_norm': [[[0.5159, 0.4378],
      [0.6974, 0.4378],
      [0.6974, 0.4519],
      [0.5159, 0.4519]]],
    'confidence': 0.9175},
   'vat': {'value': '13.86',
    'bboxes': [[[1041, 1181], [1181, 1181], [1181, 1224], [1041, 1224]]],
    'bboxes_norm': [[[0.6116, 0.3618],
      [0.6939, 0.3618],
      [0.6939, 0.375],
      [0.6116, 0.375]]],
    'confidence': 0.9982},
   'water_sp_price': {'value': '170.00',
    'bboxes': [[[1002, 871], [1174, 871], [1174, 917], [1002, 917]]],
    'bboxes_norm': [[[0.5887, 0.2669],
      [0.6898, 0.2669],
      [0.6898, 0.2809],
      [0.5887, 0.2809]]],
    'confidence': 0.9847}}]}

{'status': 'error',
 'request_id': '733a9726da624c3e2c1cd2c516a8913b',
 'error': [{'object': 'error',
   'code': 'bad_request',
   'message': 'Image too small'},
  {'object': 'error', 'code': 'bad_request', 'message': 'success page is 0'}],
 'data': []}

{'status': 'error',
 'error': [{'object': 'error',
   'code': 'partial_contents',
   'message': 'Page 2 : can not recognised'}],
 'data': [{'acc_no': {'value': '42503185',
    'bboxes': [[[478, 570], [684, 570], [684, 612], [478, 612]]],
    'bboxes_norm': [[[0.289, 0.2437],
      [0.4135, 0.2437],
      [0.4135, 0.2617],
      [0.289, 0.2617]]],
    'confidence': 0.9982},
   'billing_issue_date': {'value': '01/64',
    'bboxes': [[[1343, 304], [1438, 304], [1438, 343], [1343, 343]]],
    'bboxes_norm': [[[0.812, 0.13],
      [0.8694, 0.13],
      [0.8694, 0.1466],
      [0.812, 0.1466]]],
    'confidence': 0.9982},
   'branch_id': {'value': '04-03',
    'bboxes': [[[277, 582], [401, 582], [401, 615], [277, 615]]],
    'bboxes_norm': [[[0.1675, 0.2488],
      [0.2424, 0.2488],
      [0.2424, 0.2629],
      [0.1675, 0.2629]]],
    'confidence': 0.9982},
   'customer_name': {},
   'deduction_price': {'value': '0.00',
    'bboxes': [[[974, 940], [1065, 940], [1065, 975], [974, 975]]],
    'bboxes_norm': [[[0.5889, 0.4019],
      [0.6439, 0.4019],
      [0.6439, 0.4168],
      [0.5889, 0.4168]]],
    'confidence': 0.9982},
   'home_address': {},
   'invoice_no': {'value': '003790-3',
    'bboxes': [[[987, 554], [1134, 554], [1134, 596], [987, 596]]],
    'bboxes_norm': [[[0.5967, 0.2369],
      [0.6856, 0.2369],
      [0.6856, 0.2548],
      [0.5967, 0.2548]]],
    'confidence': 0.9982},
   'monthly_service_price': {'value': '25.00',
    'bboxes': [[[946, 1005], [1065, 1005], [1065, 1040], [946, 1040]]],
    'bboxes_norm': [[[0.5719, 0.4297],
      [0.6439, 0.4297],
      [0.6439, 0.4446],
      [0.5719, 0.4446]]],
    'confidence': 0.9981},
   'overdue_number': {'value': '1',
    'bboxes': [[[458, 1242], [646, 1242], [646, 1298], [458, 1298]]],
    'bboxes_norm': [[[0.2769, 0.531],
      [0.3906, 0.531],
      [0.3906, 0.5549],
      [0.2769, 0.5549]]],
    'confidence': 0.9982},
   'overdue_price': {'value': '258.14',
    'bboxes': [[[917, 1253], [1065, 1253], [1065, 1288], [917, 1288]]],
    'bboxes_norm': [[[0.5544, 0.5357],
      [0.6439, 0.5357],
      [0.6439, 0.5507],
      [0.5544, 0.5507]]],
    'confidence': 0.9961},
   'payment_due_date': {'value': '09/01/64',
    'bboxes': [[[863, 1438], [1066, 1438], [1066, 1473], [863, 1473]]],
    'bboxes_norm': [[[0.5218, 0.6148],
      [0.6445, 0.6148],
      [0.6445, 0.6298],
      [0.5218, 0.6298]]],
    'confidence': 0.9953},
   'total_monthly_price': {'value': '230.37',
    'bboxes': [[[919, 1181], [1063, 1181], [1063, 1216], [919, 1216]]],
    'bboxes_norm': [[[0.5556, 0.5049],
      [0.6427, 0.5049],
      [0.6427, 0.5199],
      [0.5556, 0.5199]]],
    'confidence': 0.9982},
   'total_price': {'value': '488.51',
    'bboxes': [[[833, 1340], [1060, 1340], [1060, 1372], [833, 1372]]],
    'bboxes_norm': [[[0.5036, 0.5729],
      [0.6409, 0.5729],
      [0.6409, 0.5866],
      [0.5036, 0.5866]]],
    'confidence': 0.9982},
   'vat': {'value': '15.07',
    'bboxes': [[[949, 1132], [1063, 1132], [1063, 1167], [949, 1167]]],
    'bboxes_norm': [[[0.5738, 0.484],
      [0.6427, 0.484],
      [0.6427, 0.4989],
      [0.5738, 0.4989]]],
    'confidence': 0.9982},
   'water_sp_price': {'value': '187.00',
    'bboxes': [[[924, 874], [1066, 874], [1066, 914], [924, 914]]],
    'bboxes_norm': [[[0.5586, 0.3737],
      [0.6445, 0.3737],
      [0.6445, 0.3908],
      [0.5586, 0.3908]]],
    'confidence': 0.9982}},
  {'acc_no': {},
   'billing_issue_date': {},
   'branch_id': {},
   'customer_name': {},
   'deduction_price': {},
   'home_address': {},
   'invoice_no': {},
   'monthly_service_price': {},
   'overdue_number': {},
   'overdue_price': {},
   'payment_due_date': {},
   'total_monthly_price': {},
   'total_price': {},
   'vat': {},
   'water_sp_price': {}}]}

{'status': 'error',
 'request_id': '7cccf9f2fe62118f8b755685f294cf6b',
 'error': [{'object': 'error',
   'code': 'bad_request',
   'message': 'Fail to process table extraction'},
  {'object': 'error', 'code': 'bad_request', 'message': 'success page is 0'}],
 'data': []}

import requests

api = "https://apis.aigen.online/aiscript/utility-waterbill/v2"
headers = {"x-aigen-key": "<key>"}
data = {
  "image": "base64_image"
}
res = requests.post(api, json=data, headers=headers)
print(res.json())

const axios = require("axios");

const api = "https://apis.aigen.online/aiscript/utility-waterbill/v2";
const headers = { "x-aigen-key": "" };
const data = { 
               image: "<base64_string>"
             };
axios
  .post(api, data, { headers: headers })
  .then((res) => {
    console.log(res.data);
  })
  .catch((err) => {
    console.error(err.response.data);
  });

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://apis.aigen.online/aiscript/utility-waterbill/v2',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "image": "<base64_string>",
     "option" : {}
}',
  CURLOPT_HTTPHEADER => array(
    'X-AIGEN-KEY: <aigen-key>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

curl --location 'https://apis.aigen.online/aiscript/utility-waterbill/v2' \
--header 'X-AIGEN-KEY: <aigen-key>' \
--header 'Content-Type: application/json' \
--data '{
    "image": "<base64_string>"
}'

PreviousWater Meter OCR

Last updated 1 year ago