Merge pull request #6089 from MicrosoftDocs/main

7/17/2025 11:00 AM IST Publish

Author: learn-build-service-prod[bot]

articles/ai-services/language-service/index.yml

@@ -106,3 +106,9 @@ additionalContent:
         links:
         - text: Support and help
           url: ../cognitive-services-support-options.md?context=/azure/ai-services/speech-service/context/context
+      - title: Announced for Deprecation
+        links:
+        - text: Language Understanding
+          url: ../luis/index.yml
+        - text: QnA Maker
+          url: ../qnamaker/index.yml

articles/ai-services/speech-service/get-started-speech-to-text.md

@@ -6,17 +6,17 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 7/16/2025
 ms.author: eur
 ms.reviewer: eur
 ms.custom: devx-track-python, devx-track-js, devx-track-csharp, mode-other, devx-track-extended-java, devx-track-go, build-2024, ignite-2024
-zone_pivot_groups: programming-languages-speech-services-studio
-#customer intent: As a developer, I want to use Speech services to covert speech to text, from either a microphone or a file using my choice of technology.
+zone_pivot_groups: programming-languages-get-started-transcription
+#customer intent: As a developer, I want to use the Speech service to covert speech to text, from either a microphone or a file using my choice of technology.
 ---
 
 # Quickstart: Recognize and convert speech to text
 
-::: zone pivot="ai-studio"
+::: zone pivot="ai-foundry"
 [!INCLUDE [Azure AI Foundry include](includes/quickstarts/speech-to-text-basics/ai-foundry.md)]
 ::: zone-end
 
@@ -48,12 +48,12 @@ zone_pivot_groups: programming-languages-speech-services-studio
 [!INCLUDE [Swift include](includes/quickstarts/speech-to-text-basics/swift.md)]
 ::: zone-end
 
-::: zone pivot="programming-language-rest"
-[!INCLUDE [REST include](includes/quickstarts/speech-to-text-basics/rest.md)]
+::: zone pivot="programming-language-typescript"
+[!INCLUDE [TypeScript include](includes/quickstarts/speech-to-text-basics/typescript.md)]
 ::: zone-end
 
-::: zone pivot="programming-language-cli"
-[!INCLUDE [CLI include](includes/quickstarts/speech-to-text-basics/cli.md)]
+::: zone pivot="programming-language-rest"
+[!INCLUDE [REST include](includes/quickstarts/speech-to-text-basics/rest.md)]
 ::: zone-end
 
 ## Next step

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cli.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cpp.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/csharp.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/go.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/java.md

@@ -16,85 +16,88 @@ ms.author: eur
 
 You also need a *.wav* audio file on your local machine. You can use your own *.wav* file (up to 30 seconds) or download the [https://crbn.us/whatstheweatherlike.wav](https://crbn.us/whatstheweatherlike.wav) sample file.
 
-## Set up the environment
+## Setup
 
-To set up your environment, install the Speech SDK for JavaScript. Run this command: `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
+1. Create a new folder `transcription-quickstart` and go to the quickstart folder with the following command:
 
-### Set environment variables
+    ```shell
+    mkdir transcription-quickstart && cd transcription-quickstart
+    ```
+    
+1. Create the `package.json` with the following command:
 
-[!INCLUDE [Environment variables](../../common/environment-variables.md)]
-
-## Recognize speech from a file
+    ```shell
+    npm init -y
+    ```
 
-> [!TIP]
-> Try out the [Azure AI Speech Toolkit](https://marketplace.visualstudio.com/items?itemName=ms-azureaispeech.azure-ai-speech-toolkit) to easily build and run samples on Visual Studio Code.
+1. Install the Speech SDK for JavaScript with:
 
-Follow these steps to create a Node.js console application for speech recognition.
+    ```console
+    npm install microsoft-cognitiveservices-speech-sdk
+    ```
 
-1. Open a command prompt window where you want the new project, and create a new file named *SpeechRecognition.js*.
-1. Install the Speech SDK for JavaScript:
-
-   ```console
-   npm install microsoft-cognitiveservices-speech-sdk
-   ```
+### Retrieve resource information
 
-1. Copy the following code into *SpeechRecognition.js*:
-
-   ```javascript
-   const fs = require("fs");
-   const sdk = require("microsoft-cognitiveservices-speech-sdk");
-
-   // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-   const speechConfig = sdk.SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
-   speechConfig.speechRecognitionLanguage = "en-US";
-
-   function fromFile() {
-       let audioConfig = sdk.AudioConfig.fromWavFileInput(fs.readFileSync("YourAudioFile.wav"));
-       let speechRecognizer = new sdk.SpeechRecognizer(speechConfig, audioConfig);
-
-       speechRecognizer.recognizeOnceAsync(result => {
-           switch (result.reason) {
-               case sdk.ResultReason.RecognizedSpeech:
-                   console.log(`RECOGNIZED: Text=${result.text}`);
-                   break;
-               case sdk.ResultReason.NoMatch:
-                   console.log("NOMATCH: Speech could not be recognized.");
-                   break;
-               case sdk.ResultReason.Canceled:
-                   const cancellation = sdk.CancellationDetails.fromResult(result);
-                   console.log(`CANCELED: Reason=${cancellation.reason}`);
-
-                   if (cancellation.reason == sdk.CancellationReason.Error) {
-                       console.log(`CANCELED: ErrorCode=${cancellation.ErrorCode}`);
-                       console.log(`CANCELED: ErrorDetails=${cancellation.errorDetails}`);
-                       console.log("CANCELED: Did you set the speech resource key and region values?");
-                   }
-                   break;
-           }
-           speechRecognizer.close();
-       });
-   }
-   fromFile();
-   ```
+[!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
-1. In *SpeechRecognition.js*, replace *YourAudioFile.wav* with your own *.wav* file. This example only recognizes speech from a *.wav* file. For information about other audio formats, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md). This example supports up to 30 seconds of audio.
+## Recognize speech from a file
 
-1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, use `es-ES` for Spanish (Spain). If you don't specify a language, the default is `en-US`. For details about how to identify one of multiple languages that might be spoken, see [Language identification](~/articles/ai-services/speech-service/language-identification.md).
+To transcribe speech from a file:
+
+1. Create a new file named *transcription.js* with the following content:
+
+    ```javascript
+    import { readFileSync } from "fs";
+    import { SpeechConfig, AudioConfig, SpeechRecognizer, ResultReason, CancellationDetails, CancellationReason } from "microsoft-cognitiveservices-speech-sdk";
+    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
+    const speechConfig = SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
+    speechConfig.speechRecognitionLanguage = "en-US";
+    function fromFile() {
+        const audioConfig = AudioConfig.fromWavFileInput(readFileSync("YourAudioFile.wav"));
+        const speechRecognizer = new SpeechRecognizer(speechConfig, audioConfig);
+        speechRecognizer.recognizeOnceAsync((result) => {
+            switch (result.reason) {
+                case ResultReason.RecognizedSpeech:
+                    console.log(`RECOGNIZED: Text=${result.text}`);
+                    break;
+                case ResultReason.NoMatch:
+                    console.log("NOMATCH: Speech could not be recognized.");
+                    break;
+                case ResultReason.Canceled:
+                    const cancellation = CancellationDetails.fromResult(result);
+                    console.log(`CANCELED: Reason=${cancellation.reason}`);
+                    if (cancellation.reason === CancellationReason.Error) {
+                        console.log(`CANCELED: ErrorCode=${cancellation.ErrorCode}`);
+                        console.log(`CANCELED: ErrorDetails=${cancellation.errorDetails}`);
+                        console.log("CANCELED: Did you set the speech resource key and region values?");
+                    }
+                    break;
+            }
+            speechRecognizer.close();
+        });
+    }
+    fromFile();
+    ```
+
+    In *transcription.js*, replace *YourAudioFile.wav* with your own *.wav* file. This example only recognizes speech from a *.wav* file. For information about other audio formats, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md). This example supports up to 30 seconds of audio.
+
+    To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, use `es-ES` for Spanish (Spain). If you don't specify a language, the default is `en-US`. For details about how to identify one of multiple languages that might be spoken, see [Language identification](~/articles/ai-services/speech-service/language-identification.md).
 
 1. Run your new console application to start speech recognition from a file:
 
    ```console
-   node.exe SpeechRecognition.js
+   node transcription.js
    ```
 
-   > [!IMPORTANT]
-   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
+Wait a few moments to get the response.
 
-   The speech from the audio file should be output as text:
+## Output
 
-   ```output
-   RECOGNIZED: Text=I'm excited to try speech to text.
-   ```
+The speech from the audio file should be output as text:
+
+```output
+RECOGNIZED: Text=I'm excited to try speech to text.
+```
 
 ## Remarks
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/javascript.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/python.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 01/30/2024
+ms.date: 7/16/2025
 ms.author: eur
 ---