Skip to content

Commit e11b0b5

Browse files
authored
Update rest-speech-to-text-short.md
1 parent 8619faa commit e11b0b5

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

articles/cognitive-services/Speech-Service/rest-speech-to-text-short.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -50,20 +50,6 @@ Audio is sent in the body of the HTTP `POST` request. It must be in one of the f
5050
> [!NOTE]
5151
> The preceding formats are supported through the REST API for short audio and WebSocket in the Speech service. The [Speech SDK](speech-sdk.md) supports the WAV format with PCM codec as well as [other formats](how-to-use-codec-compressed-audio-input-streams.md).
5252
53-
## Query parameters
54-
55-
These parameters might be included in the query string of the REST request.
56-
57-
> [!NOTE]
58-
> You must append the language parameter to the URL to avoid receiving a 4xx HTTP error. For example, the language set to US English via the West US endpoint is: `https://westus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US`.
59-
60-
| Parameter | Description | Required or optional |
61-
|-----------|-------------|---------------------|
62-
| `language` | Identifies the spoken language that's being recognized. See [Supported languages](language-support.md?tabs=stt-tts). | Required |
63-
| `format` | Specifies the result format. Accepted values are `simple` and `detailed`. Simple results include `RecognitionStatus`, `DisplayText`, `Offset`, and `Duration`. Detailed responses include four different representations of display text. The default setting is `simple`. | Optional |
64-
| `profanity` | Specifies how to handle profanity in recognition results. Accepted values are: <br><br>`masked`, which replaces profanity with asterisks. <br>`removed`, which removes all profanity from the result. <br>`raw`, which includes profanity in the result. <br><br>The default setting is `masked`. | Optional |
65-
| `cid` | When you're using the [Speech Studio](speech-studio-overview.md) to create [custom models](./custom-speech-overview.md), you can take advantage of the **Endpoint ID** value from the **Deployment** page. Use the **Endpoint ID** value as the argument to the `cid` query string parameter. | Optional |
66-
6753
## Request headers
6854

6955
This table lists required and optional headers for speech-to-text requests:
@@ -78,7 +64,21 @@ This table lists required and optional headers for speech-to-text requests:
7864
| `Expect` | If you're using chunked transfer, send `Expect: 100-continue`. The Speech service acknowledges the initial request and awaits additional data.| Required if you're sending chunked audio data. |
7965
| `Accept` | If provided, it must be `application/json`. The Speech service provides results in JSON. Some request frameworks provide an incompatible default value. It's good practice to always include `Accept`. | Optional, but recommended. |
8066

81-
## Pronunciation assessment parameters
67+
## Query parameters
68+
69+
These parameters might be included in the query string of the REST request.
70+
71+
> [!NOTE]
72+
> You must append the language parameter to the URL to avoid receiving a 4xx HTTP error. For example, the language set to US English via the West US endpoint is: `https://westus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US`.
73+
74+
| Parameter | Description | Required or optional |
75+
|-----------|-------------|---------------------|
76+
| `language` | Identifies the spoken language that's being recognized. See [Supported languages](language-support.md?tabs=stt-tts). | Required |
77+
| `format` | Specifies the result format. Accepted values are `simple` and `detailed`. Simple results include `RecognitionStatus`, `DisplayText`, `Offset`, and `Duration`. Detailed responses include four different representations of display text. The default setting is `simple`. | Optional |
78+
| `profanity` | Specifies how to handle profanity in recognition results. Accepted values are: <br><br>`masked`, which replaces profanity with asterisks. <br>`removed`, which removes all profanity from the result. <br>`raw`, which includes profanity in the result. <br><br>The default setting is `masked`. | Optional |
79+
| `cid` | When you're using the [Speech Studio](speech-studio-overview.md) to create [custom models](./custom-speech-overview.md), you can take advantage of the **Endpoint ID** value from the **Deployment** page. Use the **Endpoint ID** value as the argument to the `cid` query string parameter. | Optional |
80+
81+
### Pronunciation assessment parameters
8282

8383
This table lists required and optional parameters for pronunciation assessment:
8484

0 commit comments

Comments
 (0)