GiellaLT

GiellaLT provides an infrastructure for rule-based language technology aimed at minority and indigenous languages, and streamlines building anything from keyboards to speech technology. Read more about Why. See also How to get started, and our Privacy document.

REST and GraphQL API’s

Production use

There’s a production api server for various services at:

https://api-giellalt.uit.no/

The API’s can be accessed both using REST and GraphQL, more info behind the links at the bottom.

To get an overview over available services, just click the link above.

More services will be added over time.

The production server is monitored for uptime, and has multiple virtual machines to avoid downtime. Updates will only be done after update candidates have been tested and verified on the beta/staging API server (see next).

Beta / staging API server

https://beta.api.giellalt.org/

This API server is used for internal testing and verification before updating the production server. It has no guaranteed uptime, and also both linguistic and technical quality of the various services may vary. It is NOT intended for production use.

Documentation

API documentation is available directly at api-giellalt.uit.no. More info about the usage of existing services can be found at https://divvun.github.io/divvun-api/redoc-static.html and https://divvun.github.io/divvun-api/.

Some examples

Grammar

Command:

curl -s -X POST -H 'Content-Type: application/json' \
     'https://api-giellalt.uit.no/grammar/se' \
     --data '{"text": "mun hálat davvvisámegiela"}' | jq

Output:

{
  "text": "mun hálat davvvisámegiela",
  "errs": [
    {
      "error_text": "hálat",
      "start_index": 4,
      "end_index": 9,
      "error_code": "syn-number_congruence-subj-verb",
      "description": "Kongrueansa subjeavtta ja vearbba gaskkas",
      "suggestions": [
        "hálan"
      ],
      "title": "Boasttuhápmi"
    },
    {
      "error_text": "davvvisámegiela",
      "start_index": 10,
      "end_index": 25,
      "error_code": "typo",
      "description": "Ii leat sátnelisttus",
      "suggestions": [
        "davvisámegiela",
        "davvisámegiella",
        "davvesámegiela",
        "davvisámegeali",
        "davvisámegeale",
        "davvisámegealo",
        "davvisámegielu",
        "davvisámegealu"
      ],
      "title": "Čállinmeattáhus"
    }
  ]
}

Speller

Command:

curl -s -X POST -H 'Content-Type: application/json' \
     'https://api-giellalt.uit.no/speller/se' \    
     --data '{"text": "mun hálan davvvisámegiela"}' | jq

Output:

{
  "text": "mun hálan davvvisámegiela",
  "results": [
    {
      "word": "mun",
      "is_correct": true,
      "suggestions": [
        {
          "value": "mun",
          "weight": 9.547852
        },
        {
          "value": "mon",
          "weight": 9.609375
        },
        ...
      ]
    },
    {
      "word": "hálan",
      "is_correct": true,
      "suggestions": [
        {
          "value": "hálan",
          "weight": 13.608398
        },
        {
          "value": "hállan",
          "weight": 21.047852
        },
        ...
      ]
    },
    {
      "word": "davvvisámegiela",
      "is_correct": false,
      "suggestions": [
        {
          "value": "davvisámegiela",
          "weight": 30.3018
        },
        {
          "value": "davvisámegiella",
          "weight": 38.3018
        },
        ...
      ]
    }
  ]
}

Speech synthesis / TTS

curl -s -X POST -H 'Content-Type: application/json' \
  --data '{"text": "– Lea dehálaš ahte Stuorradiggi oažžu eanadoallošiehtadusa mollii."}' \
  'https://api-giellalt.uit.no/tts/se/sunna' > test.wav

API web access

All end points can be opened in a web browser for easy testing. As the list of languages and services will expand over time, the list of links below may not be complete. Run the language query to get an updated list of languages and services.

NB! Note that these web pages are only intended for testing by developers, not for real usage. They are completely bare-bones, and not meant for actual use.

These are links directly to some pages:

Grammar

Speller

TTS / Speech synthesis

Sitemap