Merge pull request #740 from sally-baolian/VideoTranslaitonAPI-New

Video translation API docs update

Author: v-ccolin

articles/ai-services/.openpublishing.redirection.ai-services.json

@@ -484,6 +484,11 @@
       "source_path_from_root": "/articles/ai-services/language-service/summarization/custom/quickstart.md",
       "redirect_url": "/azure/ai-services//language-service/summarization/overview",
       "redirect_document_id": false
-    }
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/speech-service/video-translation-studio.md",
+      "redirect_url": "/azure/ai-services/speech-service/video-translation-get-started",
+      "redirect_document_id": true
+   }
   ]
-}
+}

articles/ai-services/speech-service/includes/how-to/video-translation/rest.md

@@ -1,25 +1,19 @@
 ---
-title: How to use video translation in the studio
-titleSuffix: Azure AI services
-description: With Azure AI Speech video translation, you can seamlessly translate and generate videos in multiple languages automatically. 
-manager: nitinme
+title: include file
+description: include file
+author: sally-baolian
+ms.author: v-baolianzou
 ms.service: azure-ai-speech
-ms.topic: how-to
-ms.date: 9/24/2024
-ms.reviewer: sally-baolian
-ms.author: eur
-author: eric-urban
-ms.custom: references_regions
-#Customer intent: As a developer, I want to learn how to use video translation in the studio.
+ms.topic: include
+ms.date: 10/11/2024
+ms.custom: include
 ---
 
-# Video translation in the studio
-
-[!INCLUDE [Feature preview](../includes/preview-feature.md)]
+[!INCLUDE [Feature preview](../../../../includes/preview-feature.md)]
 
 In this article, you learn how to use Azure AI Speech video translation in the studio.
 
-All it takes to get started is an original video. See if video translation supports your [language](language-support.md?tabs=speech-translation#video-translation) and [region](video-translation-overview.md#supported-regions-and-languages).
+All it takes to get started is an original video. See if video translation supports your [language](../../../language-support.md?tabs=speech-translation#video-translation) and [region](../../../video-translation-overview.md#supported-regions-and-languages).
 
 ## Create a video translation project
 
@@ -35,25 +29,27 @@ To create a video translation project, follow these steps:
 
 1. On the **New project** page, select **Voice type**.
 
-   :::image type="content" source="media/video-translation/select-voice-type.png" alt-text="Screenshot of selecting voice type on the new project page.":::
+   :::image type="content" source="../../../media/video-translation/select-voice-type.png" alt-text="Screenshot of selecting voice type on the new project page.":::
 
    You can select **Prebuilt neural voice** or **Personal voice** for **Voice type**. For prebuilt neural voice, the system automatically 
-   selects the most suitable prebuilt voice by matching the speaker's voice in the video with prebuilt voices. For personal voice, the 
-   system provides the model with superior voice cloning similarity. To use personal voice, you need to apply for [access](https://aka.ms/customneural). 
+   selects the most suitable prebuilt voice by matching the speaker's voice in the video with prebuilt voices. For personal voice, the system offers a model that generates high-quality voice replication in a few seconds.
+
+   >[!NOTE]
+   > To use personal voice, you need to apply for [access](https://aka.ms/customneural). 
     
 1. Upload your video file by dragging and dropping the video file or selecting the file manually.
 
-   :::image type="content" source="media/video-translation/upload-video-file.png" alt-text="Screenshot of uploading your video file on the new project page.":::
+   :::image type="content" source="../../../media/video-translation/upload-video-file.png" alt-text="Screenshot of uploading your video file on the new project page.":::
 
    Ensure the video is in .mp4 format, less than 500 MB, and shorter than 60 minutes.
 
 1. Provide **Project name**, and select **Number of speakers**,  **Language of the video**, **Translate to** language.
 
-    :::image type="content" source="media/video-translation/provide-video-information.png" alt-text="Screenshot of providing video information on the new project page.":::
+    :::image type="content" source="../../../media/video-translation/provide-video-information.png" alt-text="Screenshot of providing video information on the new project page.":::
 
    If you want to use your own subtitle files, select **Add subtitle file**. You can choose to upload either the source subtitle file or the target subtitle file. The subtitle file can be in WebVTT or JSON format. You can download a sample VTT file for your reference by selecting **Download sample VTT file**.
 
-   :::image type="content" source="media/video-translation/add-subtitle-file.png" alt-text="Screenshot of adding subtitle file on the new project page.":::
+   :::image type="content" source="../../../media/video-translation/add-subtitle-file.png" alt-text="Screenshot of adding subtitle file on the new project page.":::
 
 1. After reviewing the pricing information and code of conduct, then proceed to create the project.
 
@@ -73,18 +69,18 @@ You can adjust the time frame of the scripts directly using the audio waveform b
 
 If you encounter segments with an "unidentified" voice name, it might be because the system couldn't accurately detect the voice, especially in situations where speaker voices overlap. In such cases, it's advisable to manually change the voice name.  
 
-:::image type="content" source="media/video-translation/voice-unidentified.png" alt-text="Screenshot of one segment with unidentified voice name.":::
+:::image type="content" source="../../../media/video-translation/voice-unidentified.png" alt-text="Screenshot of one segment with unidentified voice name.":::
 
 If you want to adjust the voice, select **Voice settings** to make some changes. On the **Voice settings** page, you can adjust the voice type, gender, and the voice. Select the voice sample on the right of **Voice** to determine your voice selection. If you find there is missing voice, you can add the new voice name by selecting **Add speaker**. After changing the settings, select **Update**. 
 
- :::image type="content" source="media/video-translation/voice-settings.png" alt-text="Screenshot of adjusting voice settings on the voice settings page.":::
+ :::image type="content" source="../../../media/video-translation/voice-settings.png" alt-text="Screenshot of adjusting voice settings on the voice settings page.":::
 
 If you make changes multiple times but haven't finished, you only need to save the changes you've made by selecting **Save**. After making all changes, select **Apply changes** to apply them to the video. You'll be charged only after you select **Apply changes**. 
 
- :::image type="content" source="media/video-translation/apply-changes.png" alt-text="Screenshot of selecting apply changes button after making all changes.":::
+ :::image type="content" source="../../../media/video-translation/apply-changes.png" alt-text="Screenshot of selecting apply changes button after making all changes.":::
 
 You can translate the original video into a new language by selecting **New language**. On the **Translate** page, you can choose a new translated language and voice type. Once the video file has been translated, a new project is automatically created. 
 
 ## Related content
 
-- [Video translation overview](video-translation-overview.md)
+- [Video translation overview](../../../video-translation-overview.md)

articles/ai-services/speech-service/video-translation-studio.md renamed to articles/ai-services/speech-service/includes/how-to/video-translation/speech-studio.md

@@ -6,6 +6,12 @@ ms.date: 7/12/2024
 ms.author: eur
 ---
 
+### October 2024 release
+
+#### Video translation (Preview)
+
+The video translation API is now available in public preview. For more information, see the [How to use video translation](../../video-translation-get-started.md?pivots=rest-api).
+
 ### September 2024 release
 
 #### Fast transcription (Preview)

articles/ai-services/speech-service/includes/release-notes/release-notes-stt.md

@@ -232,8 +232,8 @@ items:
       items:
        - name: Video translation overview
          href: video-translation-overview.md
-       - name: Video translation in the studio
-         href: video-translation-studio.md
+       - name: How to use video translation
+         href: video-translation-get-started.md
 - name: Intent recognition
   items:
     - name: Intent recognition overview

articles/ai-services/speech-service/media/video-translation/video-translation-api-workflow.png

@@ -0,0 +1,23 @@
+---
+title: How to use video translation - Speech service
+titleSuffix: Azure AI services
+description: Learn about how to use video translation. 
+author: sally-baolian
+manager: nitinme
+ms.service: azure-ai-speech
+ms.topic: how-to
+ms.date: 10/11/2024
+ms.author: v-baolianzou
+zone_pivot_groups: speech-studio-rest
+#Customer intent: As a developer, I want to learn how to use video translation.
+---
+
+# How to use video translation
+
+::: zone pivot="speech-studio"
+[!INCLUDE [Speech Studio include](./includes/how-to/video-translation/speech-studio.md)]
+::: zone-end
+
+::: zone pivot="rest-api"
+[!INCLUDE [REST API include](./includes/how-to/video-translation/rest.md)]
+::: zone-end

articles/ai-services/speech-service/toc.yml

@@ -63,13 +63,13 @@ We support video translation between various languages, enabling you to tailor y
 
 ## Get started 
 
-To get started with video translation, refer to [video translation in the studio](video-translation-studio.md). The video translation API will be available soon.
+To get started with video translation, refer to [How to use video translation](video-translation-get-started.md).
 
 ## Price 
 
 For pricing details on video translation, see [Speech service pricing](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/). Note that video translation pricing will only be visible for [service regions](#supported-regions-and-languages) where the feature is available.
 
 ## Related content
 
-* Try the [video translation in the studio](video-translation-studio.md)
-  
+* Try the [video translation](video-translation-get-started.md)
+