For Azure NER, when using the REST API, modelVersion "latest" does not work as expected

Peter Kissmann 0

When running a Named Entity Recognition request against the REST API, according to the help (https://aka.ms/text-analytics-model-versioning) the model version "latest" should result in using the newest model. On the same page, the latest GA model version is 2023-04-15. However, when I run a query, the response tells me that the used model is 2021-06-01. When explicitly setting the model version to 2023-04-15, an error is returned:

Invalid model version. Possible values are: latest,2021-06-01,2023-09-01. For additional details see https://aka.ms/text-analytics-model-versioning

It seems that (a) the info in the help is outdated (a newer model is already available), and (b) the model version "latest" does not work as expected, using a much older model. Or am I missing something regarding the "latest" model version? Shouldn't it use the 2023-09-01 model?

VasaviLankipalle-MSFT 17,026 Reputation points

2023-09-26T21:21:30.6033333+00:00

Hello @Peter Kissmann , Thanks for using Microsoft Q&A Platform.

Is it possible to share the sample response (along with API version, model version) with us to reproduce the same on our end?

Peter Kissmann 0

Sure enough. We have called a URL like this: https://<our-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

An example for the request body is

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "text": "Some text"
            }
        ]
    }
}

and the response is this

{
    "kind": "EntityRecognitionResults",
    "results": {
        "documents": [
            {
                "id": "1",
                "entities": [],
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2021-06-01"
    }
}

So, we have used API version 2022-05-01 (from what I have gathered from the API description, this seems to be the latest version for entity recognition), modelVersion is set to "latest", and in the response the modelVersion is "2021-06-01". Here I have expected to get the latest GA model, which seems to be 2023-09-01.

Share via

For Azure NER, when using the REST API, modelVersion "latest" does not work as expected

Your answer