[BUG] minSpeaker / maxSpeaker setting equal not possible

[SebastianBodza]

API Spec link

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/Speech/SpeechToText/preview/2024-05-15-preview/speechtotext.json

API Spec version

2024-05-15-preview

Describe the bug

When setting the minSpeakers and maxSpeakers to the same value the api returns:
The value of min speakers should be less than the value of max speakers.

The description of the min and maxSpeakers however do not limit this and allow for equal values.
minCount: A hint for the minimum number of speakers for diarization. Must be smaller than or equal to the maxSpeakers property.
maxCount: The maximum number of speakers for diarization. Must be less than 36 and larger than or equal to the minSpeakers

Ideally the API would allow to specify exactly the amount of speakers -> allow for minSpeakers == maxSpeakers. Otherwise the description should be reworked.

Expected behavior

Allow the setting of minSpeaker = maxSpeaker to have a fixed speaker count.

Actual behavior

Throws an 400 error with The value of min speakers should be less than the value of max speakers.

Reproduction Steps

AUDIO = "<AUDIO_FILE>.mp3"
REGION = "westeurope"
url = f"https://{REGION}.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe"
params = {"api-version": "2024-05-15-preview"}

headers = {
    "Accept": "application/json",
    "Ocp-Apim-Subscription-Key": <SPEECH_API_KEY>
}

definition = {
    "locales": ["de-DE"],
    "diarizationSettings": {
        "minSpeakers": 2,
        "maxSpeakers": 2
    },
    "profanityFilterMode": "Masked",
}

files = {
    "audio": ("test.mp3", open(AUDIO, "rb")),
    "definition": (None, json.dumps(definition))
}

response = requests.post(url, params=params, headers=headers, files=files)

Environment

No response

[v-jiaodi]

@bexxx Please help take a look, thanks.