Language Models

This page explains how to retrieve the language models available for the SESTEK Speech Recognition (SR) service, and how to select a specific model version when submitting a transcription request.

Endpoint Details

Method: GET
URL: {region-base-url}/v1/speech/dictation/models
Actor: REST Service Client
Goal: Retrieve the list of available language models.
Pre-Conditions: None

Replace {region-base-url} with the base URL for your assigned region; see API Region URLs.

Example Request

This endpoint does not require an Authorization header.

curl --location 'https://srapi.knovvu.com/v1/speech/dictation/models'

Example Response

The response contains a models array, one entry per available language model. The example below shows two entries from a live response; the full list currently contains 43 models.

{
    "success": true,
    "modelsCount": 43,
    "models": [
        {
            "name": "English",
            "language": "en-US",
            "version": 9,
            "tenant": "Default",
            "type": "Sestek",
            "sample_rate": 16000,
            "frequency": 16000,
            "is_persistent": true
        },
        {
            "name": "Turkish",
            "language": "tr-TR",
            "version": 8,
            "tenant": "Default",
            "type": "Sestek",
            "sample_rate": 16000,
            "frequency": 16000,
            "is_persistent": true
        }
    ],
    "errorCode": null,
    "errorMessage": null,
    "moreInfo": null
}

Understanding Model Versions

The ModelVersion parameter lets you select a specific model version when submitting audio for transcription.

Using the Latest Model Version

To use the latest version of a model, either:

set ModelVersion=0, or
omit the ModelVersion parameter entirely.

In both cases, the system automatically selects the most up-to-date and optimized language model available.

Using a Specific Model Version

If you need an older or specific model version:

Retrieve the available versions by calling the models endpoint above.
Use the version value from the response, for the model name you want, as the ModelVersion parameter in your transcription request. For example, the response above shows English at version 9 and Turkish at version 8.

Example Request for a Specific Model Version

curl --location 'https://sr.tr.knovvu.com/v1/speech/dictation/request' \
--header 'Content-Type: audio/wave' \
--header 'ModelName: Turkish' \
--header 'ModelVersion: 4' \
--header 'Tenant: Default' \
--header 'Authorization: Bearer <access_token>' \
--data-binary '@audio.wav'

When to Use Model Versions

To use the latest version, no additional configuration is required.
To use an earlier version for consistency, for example to avoid behavior changes introduced by a newer model, specify the desired ModelVersion in your request.

Documentation Index