Language Detection API quick guide

This is a brief introduction to Intento Language detection REST API, the full REST API documentation is available by the link: https://github.com/intento/intento-api/blob/master/ai.text.detect-language.md

Language detection calls

To detect the language of a text, send a POST request to Intento API at https://api.inten.to/ai/text/detect-language. Specify the source text and the desired provider in JSON body of the request as in the following example:

curl -XPOST -H 'apikey: <YOUR_API_KEY>' 'https://api.inten.to/ai/text/detect-language' -d '
{
    "context": {
        "text": "Hello, I would like to take a class at your University.",
    },
    "service": {
        "provider": "ai.text.detect-language.microsoft.text_analytics_api.2-1"
    }
}'

Please replace <YOUR_API_KEY> with your Production Key that is available at https://console.inten.to/dashboard.

The response contains detect-language results:

{
    "results": [
        [
            {
                "language": "en",
                "confidence": 1
            }
        ]
    ],
    "meta": {},
    "service": {
        "provider": {
            "id": "ai.text.detect-language.microsoft.text_analytics_api.2-1",
            "name": "Microsoft Text Analytics API"
        }
    }
} 

The detect-language intent supports bulk requests for providers with such capability (right now only ai.text.detect-language.microsoft.text_analytics_api.2-1):

curl -XPOST -H "Trace: true" -H "apikey: <YOUR_API_KEY>" "https://api.inten.to/ai/text/detect-language" -d '
{
  "context": {
    "text": ["Hallo Welt!", "Hello world"]
  },
  "service": {
    "provider" : "ai.text.detect-language.microsoft.text_analytics_api.2-1"
  }
}'

Each segment language is detected separately:

{
    "results": [
        [
            {
                "language": "de",
                "confidence": 1.0
            }
        ],
        [
            {
                "language": "en",
                "confidence": 1.0
            }
        ]
    ],
    "meta": {},
    "service": {
        "provider": {
            "id": "ai.text.detect-language.microsoft.text_analytics_api.2-1",
            "name": "Microsoft Text Analytics API"
        }
    }
}

Getting available providers

To get a list of available Dictionary providers, send a GET request to https://api.inten.to/ai/text/detect-language.

curl -H 'apikey: <YOUR_API_KEY>' 'https://api.inten.to/ai/text/detect-language'

The response contains a list of the providers available for given constraints with information on using custom models, etc.:

[
    {
        "id": "ai.text.detect-language.microsoft.text_analytics_api.2-1",
        "vendor": "Microsoft",
        "description": "Text Analytics API",
        "production": true,
        "integrated": true,
        "billable": true,
        "own_auth": true,
        "stock_model": true,
        "custom_model": false
    },
    {
        "id": "ai.text.detect-language.google.translate_api.v3",
        "vendor": "Google Cloud",
        "description": "Advanced Translation API",
        "production": true,
        "integrated": true,
        "billable": true,
        "own_auth": true,
        "stock_model": true,
        "custom_model": false
    }
]