The Finto AI API service offers the same functionality as the Finto AI form user interface - in fact, the form is based on the same API. The API is given text and it responds with subject suggestions. Each suggestion contains a concept URI, a term (label) and a score in the range 0.0-1.0, which reflects the estimated relevance of the subject for the input document.
Take note of the following if you want to use the API:
yso-fi
, yso-sv
and yso-en
./v1/projects/
) and suggesting subjects for documents (/v1/projects/<project_id>/suggest
). You can control the number of suggestions using the limit
and threshold
parameters. The limit parameter sets the maximum number of suggestions (default 10) and the threshold sets the minimum score level for suggestions.A detailed, interactive OpenAPI/Swagger documentation for the API is available.
The Finto AI/Annif API service is being used in the JYX repository of the University of Jyväskylä, where it is used to assist the subject indexing of Master's theses. Students uploading their thesis get automatic suggestions for subjects, which they can then select and modify. The final subjects are confirmed by a librarian. A similar workflow is also in use at several institutional repositories maintained by the National Library of Finland. Also, Kirjavälitys Oy is using the API service for generating metadata about upcoming book titles.
Automated subject suggestions in the JYX repository