Det öppna gränssnittet erbjuder samma funktionalitet som Finto AI:s formulärgränssnitt - formuläret använder faktiskt samma API. Man ger API-servicen text och får som svar förslag till ämnesord. Varje förslag innehåller begreppets URI, dess term samt ett poängtal mellan 0.0 och 1.0, som visar hur relevant algoritmen tror att ämnesordet är för dokumentet.
Observera följande om du vill använda vår API:
/v1/projects/
) och förslag till ämnesord (/v1/projects/<project_id>/suggest
). Du kan kontrollera antalet förslag med parametrarna limit
och threshold
. Limit begränsar totala antalet förslag medan threshold sätter ett minimumvärde för poängtalen.Vi har också en detaljerad interaktiv OpenAPI/Swagger-specifikation för API:et.
Finto AI/Annif-gränssnittet används redan av Jyväskylä universitets JYX-publikationsarkiv, där det underlättar indexering av avhandlingar. När studerande publicerar sin avhandling i systemet, får de förslag som de sedan kan korrigera och komplettera. De slutliga ämnesorden fastställs av bibliotekspersonal. Motsvarande system är i bruk i flera andra arkiv som upprättshålls av Nationalbiblioteket. Kirjavälitys Oy använder gränssnittet för att skapa metadata för nya boktitlar.
Automatiska ämnesordsförslag i JYX-arkivet