Driver Licence OCR

Extract driver licence information from an image, including licence number, name, date of birth, and expiry date.

Extract driver license information from image

Error Definition

http status	error_code	error_message
200	-	-
400	1001	Fail to do rotate image
400	1002	Can not find driver license on picture
500	2001	some error occur in serverside

Extract driver license information from image

POST https://api.aigen.online/aiscript/driver-license/v1

Request Body

Name	Type	Description
image*	String	Input base64 image encoded utf-8

200: OK Successful response

{
  "status": "200",
  "message": "success",
  "response_id": "123wereqs2",
  "error_list": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "result": [
    {
      "keyname": "string",
      "text": "string",
      "confidence": 0
    }
  ]
}

422: Unprocessable Entity Validation error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Example code

Python

import requests
import json

api = "https://api.aigen.online/aiscript/driver-license/v1"
headers = {"x-aigen-key": "<key>", "content-type": "application/json"}
data = json.dumps({"image": "<base64_string>"})

res = requests.post(api, data=data, headers=headers)
print(res.json())

Nodejs

const axios = require("axios");

const api = "https://api.aigen.online/aiscript/driver-license/v1";
const headers = {
  "x-aigen-key": "<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

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.aigen.online/aiscript/driver-license/v1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode(array(
    "image" => "<base64_string>"
  )),
  CURLOPT_HTTPHEADER => array(
    'X-AIGEN-KEY: <aigen-key>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

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

cURL

curl --location 'https://api.aigen.online/aiscript/driver-license/v1' \
--header 'X-AIGEN-KEY: <aigen-key>' \
--header 'Content-Type: application/json' \
--data '{
    "image": "<base64_string>"
}'