update samples

Author: amber-yujueWang

sdk/cognitiveservices/azure-ai-speech-transcription/README.md

@@ -206,72 +206,72 @@ result.getCombinedPhrases().forEach(phrase -> {
 });
 ```
 
-### Use enhanced mode for improved transcription quality
+### Transcribe with multi-language support
 
-Enhanced mode provides advanced features to improve transcription accuracy with custom prompts, translation capabilities, and task-specific optimizations.
+The service can automatically detect and transcribe multiple languages within the same audio file.
 
-#### Basic enhanced mode
-
-```java readme-sample-enhancedModeBasic
+```java com.azure.ai.speech.transcription.transcriptionoptions.multilanguage
 byte[] audioData = Files.readAllBytes(Paths.get("path/to/audio.wav"));
 
 AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData))
     .setFilename("audio.wav");
 
-// Enable enhanced mode for improved transcription quality
-EnhancedModeOptions enhancedMode = new EnhancedModeOptions();
-
-TranscriptionOptions options = new TranscriptionOptions(audioFileDetails)
-    .setLocales(java.util.Arrays.asList("en-US"))
-    .setEnhancedModeOptions(enhancedMode);
+// Configure transcription WITHOUT specifying locales
+// This allows the service to auto-detect and transcribe multiple languages
+TranscriptionOptions options = new TranscriptionOptions(audioFileDetails);
 
 TranscriptionResult result = client.transcribe(options);
+
+result.getPhrases().forEach(phrase -> {
+    System.out.println("Language: " + phrase.getLocale());
+    System.out.println("Text: " + phrase.getText());
+});
 ```
 
-#### Enhanced mode with custom prompts
+### Transcribe with enhanced mode
 
-Use prompts to guide transcription with domain-specific terminology, improving accuracy for specialized content like medical, legal, or technical discussions.
+Enhanced mode provides advanced features to improve transcription accuracy with custom prompts.
 
-```java readme-sample-enhancedModeWithPrompts
+```java com.azure.ai.speech.transcription.transcriptionoptions.enhancedmode
 byte[] audioData = Files.readAllBytes(Paths.get("path/to/audio.wav"));
 
 AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData))
     .setFilename("audio.wav");
 
-// Use prompts to guide transcription with domain-specific terminology
 EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-    .setPrompts(java.util.Arrays.asList(
-        "Medical consultation discussing hypertension and diabetes",
-        "Common medications: metformin, lisinopril, atorvastatin",
-        "Patient symptoms and treatment plan"
-    ));
+    .setTask("transcribe")
+    .setPrompts(java.util.Arrays.asList("Output must be in lexical format."));
 
 TranscriptionOptions options = new TranscriptionOptions(audioFileDetails)
-    .setLocales(java.util.Arrays.asList("en-US"))
     .setEnhancedModeOptions(enhancedMode);
 
 TranscriptionResult result = client.transcribe(options);
+
+System.out.println("Transcription: " + result.getCombinedPhrases().get(0).getText());
 ```
 
-#### Enhanced mode with translation
+### Transcribe with phrase list
 
-Transcribe audio in one language and translate to another language simultaneously.
+You can use a phrase list to improve recognition accuracy for specific terms.
 
-```java readme-sample-enhancedModeWithTranslation
+```java com.azure.ai.speech.transcription.transcriptionoptions.phraselist
 byte[] audioData = Files.readAllBytes(Paths.get("path/to/audio.wav"));
 
 AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData))
     .setFilename("audio.wav");
 
-// Configure enhanced mode to transcribe Spanish audio and translate to English
-EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-    .setTargetLanguage("en-US"); // Translate to English
+PhraseListOptions phraseListOptions = new PhraseListOptions()
+    .setPhrases(java.util.Arrays.asList("Azure", "Cognitive Services"))
+    .setBiasingWeight(5.0);
 
 TranscriptionOptions options = new TranscriptionOptions(audioFileDetails)
-    .setLocales(java.util.Arrays.asList("es-ES")) // Source language: Spanish
-    .setEnhancedModeOptions(enhancedMode);
+    .setPhraseListOptions(phraseListOptions);
 
 TranscriptionResult result = client.transcribe(options);
+
+result.getCombinedPhrases().forEach(phrase -> {
+    System.out.println(phrase.getText());
+});
 ```
 
 ### Service API versions

sdk/cognitiveservices/azure-ai-speech-transcription/customization/src/main/java/SpeechTranscriptionCustomization.java

@@ -275,7 +275,7 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                         + "if (options.getFileDetails() != null) { requestContent.setAudio(options.getFileDetails()); } "
                         + "RequestOptions requestOptions = new RequestOptions(); "
                         + "Response<BinaryData> response = transcribeWithResponse("
-                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"options\", requestContent.getOptions())"
+                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"definition\", requestContent.getOptions())"
                         + ".serializeFileField(\"audio\", requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(), "
                         + "requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(), "
                         + "requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())"
@@ -359,7 +359,7 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                     .setBody(parseBlock("{ TranscriptionContent requestContent = new TranscriptionContent(options); "
                         + "if (options.getFileDetails() != null) { requestContent.setAudio(options.getFileDetails()); } "
                         + "RequestOptions requestOptions = new RequestOptions(); " + "return transcribeWithResponse("
-                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"options\", requestContent.getOptions())"
+                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"definition\", requestContent.getOptions())"
                         + ".serializeFileField(\"audio\", requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(), "
                         + "requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(), "
                         + "requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())"

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionAsyncClient.java

@@ -48,7 +48,7 @@ public final class TranscriptionAsyncClient {
     /**
      * Transcribes the provided audio stream.
      * <p><strong>Response Body Schema</strong></p>
-     * 
+     *
      * <pre>
      * {@code
      * {
@@ -115,7 +115,7 @@ Mono<TranscriptionResult> transcribe(TranscriptionContent body) {
         // Generated convenience method for transcribeWithResponse
         RequestOptions requestOptions = new RequestOptions();
         return transcribeWithResponse(
-            new MultipartFormDataHelper(requestOptions).serializeJsonField("options", body.getOptions())
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", body.getOptions())
                 .serializeFileField("audio", body.getAudio() == null ? null : body.getAudio().getContent(),
                     body.getAudio() == null ? null : body.getAudio().getContentType(),
                     body.getAudio() == null ? null : body.getAudio().getFilename())
@@ -165,7 +165,7 @@ public Mono<Response<TranscriptionResult>> transcribeWithResponse(TranscriptionO
         }
         RequestOptions requestOptions = new RequestOptions();
         return transcribeWithResponse(
-            new MultipartFormDataHelper(requestOptions).serializeJsonField("options", requestContent.getOptions())
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", requestContent.getOptions())
                 .serializeFileField("audio",
                     requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(),
                     requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(),

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionClient.java

@@ -46,7 +46,7 @@ public final class TranscriptionClient {
     /**
      * Transcribes the provided audio stream.
      * <p><strong>Response Body Schema</strong></p>
-     * 
+     *
      * <pre>
      * {@code
      * {
@@ -112,7 +112,7 @@ TranscriptionResult transcribe(TranscriptionContent body) {
         // Generated convenience method for transcribeWithResponse
         RequestOptions requestOptions = new RequestOptions();
         return transcribeWithResponse(
-            new MultipartFormDataHelper(requestOptions).serializeJsonField("options", body.getOptions())
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", body.getOptions())
                 .serializeFileField("audio", body.getAudio() == null ? null : body.getAudio().getContent(),
                     body.getAudio() == null ? null : body.getAudio().getContentType(),
                     body.getAudio() == null ? null : body.getAudio().getFilename())
@@ -161,7 +161,7 @@ public Response<TranscriptionResult> transcribeWithResponse(TranscriptionOptions
         }
         RequestOptions requestOptions = new RequestOptions();
         Response<BinaryData> response = transcribeWithResponse(
-            new MultipartFormDataHelper(requestOptions).serializeJsonField("options", requestContent.getOptions())
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", requestContent.getOptions())
                 .serializeFileField("audio",
                     requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(),
                     requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(),