smartClassifyPlus - Laigo GmbH

Docs Navigation

Model-Background

Empower your document management system with smartClassifyPlus, a highly flexible and powerful document classification solution. Designed for integration with any IDP system, smartClassifyPlus offers the ability to classify documents into various categories including letters, forms, emails, handwritten documents, advertisements, scientific reports, publications, specifications, and file folders. Harness the capabilities of smartClassifyPlus to simplify and enhance your document classification process.

Limitations

Max File Size is 8 MB
Max requests per second: 1
Processing Time: Up to the number of characters in an image

Licenses

API Call

Requests to the SmartClassifyPlus API must be authenticated. Requests are authenticated by providing an “Authorization” header with an access token. Access tokens are obtained by calling the endpoint shown below and then the required secrets are available in the API tab for your task.

				
					https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token

If you are not sure how to get the access token please visit “Make your first request” page to get that information.

Upload a file

POST

				
					https://use.laigo.io/api/api/FileUpload/v1/Upload/smartClassifyPlus

Parameters	Description
accessToken	A JWT issued to your application by the Laigo identity provider.
inputFileName	The path to the image file to use as input

cURL

Python

HTML & JavaScript

PHP

cURL

				
					curl -X POST \
https://laigo.io/api/FileUpload/v1/Upload/smartClassifyPlus \
-H 'Authorization: Bearer my-api-key-here' \
-F file=@/path/to/your/file.png

Python

				
					import requests

url = "https://laigo.io/api/FileUpload/v1/Upload/smartClassifyPlus"

with open("/path/to/my/file", "rb") as myfile:
    files = {"file": myfile}
    headers = {"Authorization": "Bearer my-api-key-here"}
    response = requests.post(url, files=files, headers=headers)
    print(response.text)

HTML & JavaScript

				
					<form onsubmit="laigoSubmit(event)" >
  <input type="file" id="my-file-input" name="file" />
  <input type="submit" />
</form>

<script type="text/javascript">
const laigoSubmit = (evt) => {
  evt.preventDefault()
  let myFileInput = document.getElementById('my-file-input');
  let myFile = myFileInput.files[0]
  if (!myFile) { return }
  let data = new FormData();
  data.append("file", myFile, myFile.name);

  let xhr = new XMLHttpRequest();

  xhr.addEventListener("readystatechange", function () {
    if (this.readyState === 4) {
      console.log(this.responseText);
    }
  });

  xhr.open("POST", "https://laigo.io/api/api/FileUpload/v1/Upload/smartClassifyPlus");
  xhr.setRequestHeader("Authorization", "Bearer my-api-key-here");
  xhr.send(data);
}
</script>

PHP

				
					<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://laigo.io/api/FileUpload/v1/Upload/smartClassifyPlus',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file'=> new CURLFILE('<your-file-here>')),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <your-token-here>'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example Response

				
					{ 
    "class": "advertisement"
}

Status code	Message
200	Request was successfully
201	Created – Upload was successfully
400	Bad Request – missing or wrong Parameter

Error Messages

While using smartClassifyPlus API there could be some error messages, that are done for file validation checking:

Error Message	Description
Please send the correct input file format!	The file format is not (PNG,JPG) or (PDF)
Please send a file that doesn’t exceed the size limit!	The file size is more than the allowed limit (number)
Please make sure that your file doesn’t contain any suspicious malware data!	The file contains suspicious data, then security check system warns you
You have ran out of Laigos, renew your subscription to continue using Laigo APIs!	All of your Laigos are used, please renew your subscription

Example (step by step)

1.First you need to have a document sample that you want to use with smartClassifyPlus. It can be any document type such as: invoice, receipt, letter, email etc. For e.g you can use the invoice advertisement below:

2.Inorder to use our smartClassifyPlus tool you need to have an API key which can be generated from here.

If you don’t have an account, first you need to set up your account then you can generate the API key. Create an account here.

3. After you have generated your API key, then you can use smartClassifyPlus in any popular programming language, where you can find the code snippets here.

4. Run your code. You will receive a JSON response with the invoice details. See expected responses here.

Credits (Laigo)

The calcualtion of processing a page:

Page	Laigos
1	1

EU-AI Act Reports

TECHNICAL DOCUMENTATION referred to in Article 11(1)

1. A general description of the AI system including:

(a) its intended purpose,

The AI system smartClassifyPlus is classifying English documents to their respective document types. It is classifying between letter, form, email, handwritten, advertisement, scientific report, scientific publication, specification, file folder, news article, budget, invoice, presentation, questionnaire, resume, memo.

the person/s developing the system the date and the version of the system;

The AI system smartClassifyPlus was developed at

Laigo GmbH
Eckenerstr. 65
88046 Friedrichshafen

and

Laigo DOO
Cevahir Sky City, 16B
Municipality Aerodrom, 1000 Skopje
North Macedonia

Releasing Version 1.0 of the AI system, on the 20.12.2022.

b) how the AI system interacts or can be used to interact with hardware or software that is not part of the AI system itself, where applicable;

The AI system is integrated on the webpage https://laigo.ai/ and can be called by using API. It is served on Laigo internal servers.

[…]

(d) the description of all forms in which the AI system is placed on the market or put into service;

The AI system is integrated on the webpage https://laigo.ai/ and can be called by using API. It is served on Laigo internal servers.

(e) the description of hardware on which the AI system is intended to run;

The AI system smartClassifyPlus is running on Laigo internal server, located in Germany.

(f) where the AI system is a component of products, photographs or illustrations showing external features, marking and internal layout of those products;

The AI system smartClassifyPlus is deployed on Laigos internal server, located in Germany. It is part of a Software as a Service product.

(g) instructions of use for the user and, where applicable installation instructions;

All instructions of the product usage are mentioned on Laigos homepage https://laigo.ai/docs.

2. A detailed description of the elements of the AI system and of the process for its development, including:

(a) the methods and steps performed for the development of the AI system, including, where relevant, recourse to pre-trained systems or tools provided by third parties and how these have been used, integrated or modified by the provider;

The AI system smartClassifyPlus is based on the Open Source Model Donut( Document understanding transformer) from Clova AI Research. No further adaptions or fine tunings took place at Laigo.

(b) the design specifications of the system,

No modifications has been done to the original neural network architecture. Only the output classes are changed.

namely the general logic of the AI system and of the algorithms;

This AI system classifies English document types between letter, form, email, handwritten, advertisement, scientific report, scientific publication, specification, file folder, news article, budget, invoice, presentation, questionnaire, resume, memo. Algorithm and approach can be found here: https://arxiv.org/abs/1912.13318, 20.12.2022.

the key design choices including the rationale and assumptions made, also with regard to persons or groups of persons on which the system is intended to be used;

No design choices or modifications are done from the existing system by Laigo GmbH.

the main classification choices;

Laigo GmbH classifies this AI system with “no risk”, since none of the EU requirements are applicable for this use case.

what the system is designed to optimise for and the relevance of the different parameters;

The AI system is designed to classify documents automatically without any rule based approach. With this technology and approach a higher accuracy can be reached compared to classical rule based approaches.

[…]

(c) the description of the system architecture explaining how software components build on or feed into each other and integrate into the overall processing; the computational resources used to develop, train, test and validate the AI system;

The AI system “Donut” by Clova AI Research has been served by using model serving API. Training, validation and testing of the AI model are done by Clova AI Research.

[…]

3. Detailed information about the monitoring, functioning and control of the AI system, in particular with regard to:

its capabilities and limitations in performance, including the degrees of accuracy for specific persons or groups of persons on which the system is intended to be used and the overall expected level of accuracy in relation to its intended purpose;

Especially, if the quality of the image and the resolution is bad, text can be missed or misinterpreted in a wrong language. This appears also, if the orientation of the picture/PDF is not aligned to the orientation of the text. With this, it is possible that documents are classified not properly.

The overall accuracy is independent of specific persons or groups of persons which the system is intended to be used.

the foreseeable unintended outcomes and sources of risks to health and safety, fundamental rights and discrimination in view of the intended purpose of the AI system;

No risk to health and safety expected. Fundamental rights are respected and no discrimination of certain individuals considered.

[…]

5. A description of any change made to the system through its lifecycle;

As the AI system has been released with the first version, no changes appeared so far.

[…]

EU DECLARATION OF CONFORMITY

1. AI system name and type and any additional unambiguous reference allowing identification and traceability of the AI system;

The AI system is called “smartClassifyPlus” and is based on Clova AI Research open source model “Donut”.

Information about Donut can be found in the research paper.
Changes, adaptions and interaction with Donut in the context of “smartClassifyPlus” can be found on https://laigo.ai/docs.

2. Name and address of the provider or, where applicable, their authorised representative;

Laigo GmbH .
Eckenerstr. 65
88046 Friedrichshafen

Representative: Yvonne Gaissmaier

[…]

7. Place and date of issue of the declaration, name and function of the person who signed it as well as an indication for, and on behalf of whom, that person signed, signature.

Friedrichshafen, 20.12.2022 Yvonne Gaissmaier

INFORMATION TO BE SUBMITTED UPON THE REGISTRATION OF HIGH-RISK AI SYSTEMS IN ACCORDANCE WITH ARTICLE 51

1. Name, address and contact details of the provider;

Laigo GmbH
Eckenerstr. 65
88046 Friedrichshafen

[…]

3. Name, address and contact details of the authorised representative, where applicable;

Yvonne Gaissmaier
Eckenerstr. 65
88046 Friedrichshafen

4. AI system trade name and any additional unambiguous reference allowing identification and traceability of the AI system;

The AI system trade name is “smartClassifyPlus”.

5. Description of the intended purpose of the AI system;

6. Status of the AI system (on the market, or in service; no longer placed on the market/in service, recalled);

On the market

[…]

9. Member States in which the AI system is or has been placed on the market, put into service or made available in the Union;

The AI system is placed in Friedrichshafen, Germany.

[…]

11. Electronic instructions for use; this information shall not be provided for high-risk AI systems in the areas of law enforcement and migration, asylum and border control management referred to in Annex III, points 1, 6 and 7.

Any instructions for the usage of smartClassifyPlus can be found in https://laigo.ai/docs.

12. URL for additional information (optional).

https://laigo.ai/docs

WHAT’S NEXT: