Error "Invalid language code 'de'" when using healthcare text analysis API

Question

Hi all,
when I try to use the azure text analysis API for healthcare data with a different language code, e.g. "de" I get the following error message:
"Invalid language code 'de'. Supported languages: en. For additional details see https://aka.ms/language-service/language-support"
When I check the documentation for the API it seems like the German language should be supported (see also this community question).
I am able to get results when using the "en" language code.

Here is an example request that produces the error:

POST /language/analyze-text/jobs?api-version=2023-04-01 HTTP/1.1
Host: our-host-url
Content-Type: application/json
Ocp-Apim-Subscription-Key: secret-key
Content-Length: 206

{
    "analysisInput": {
        "documents": [{
                "text": "Arzt hat 200mg Ibuprufen verschrieben.",
                "language": "de",
                "id": "1"
            }
        ]
    },
    "tasks": [{
            "taskId": "analyze 1",
            "kind": "Healthcare",
            "parameters": {
                "fhirVersion": "4.0.1"
            }
        }
    ]
}

Response:

{...
    "status": "succeeded",
    "errors": [],
    "tasks": {
        "completed": 1,
        "failed": 0,
        "inProgress": 0,
        "total": 1,
        "items": [{
                "kind": "HealthcareLROResults",
                "lastUpdateDateTime": "2024-01-23T20:23:01.5126897Z",
                "status": "succeeded",
                "results": {
                    "documents": [],
                    "errors": [{
                            "id": "1",
                            "error": {
                                "code": "InvalidArgument",
                                "message": "Invalid Language Code.",
                                "innererror": {
                                    "code": "UnsupportedLanguageCode",
                                    "message": "Invalid language code 'de'. Supported languages: en. For additional details see https://aka.ms/language-service/language-support"
                                }
                            }
                        }
                    ],
                    "modelVersion": "2023-04-01"
                }
            }
        ]
    }
}

I tried model version 2022-05-15-preview as well, which produced the same error.

It would be great if someone could let me know if this is a user error on my side or if this is a functionality that si not supported.

Thanks!

Answer 1

Hallo Veronika,

Würdest Du "taskId" durch "taskName" und "fhirVersion" durch "modelVersion" ersetzen? In dieser Anleitung https://learn.microsoft.com/en-us/rest/api/language/text-analysis-runtime/submit-job?view=rest-language-2023-04-01&tabs=HTTP werden nämlich "taskName" und "modelVersion" als Parameter aufgelistet.

Die für "modelVersion" zulässigen Werte findest Du in diesem Artikel: https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/model-lifecycle#choose-the-model-version-used-on-your-data

Für die Vorschauversionen ist die Endung -preview erforderlich, z. B.:

          "modelVersion": "2023-01-01-preview"
          "modelVersion": "2022-08-15-preview"

Gruß, Dimitar