Merge pull request #5511 from eric-urban/eur/video-translation-api

ttorble · web-flow · commit d7db36397707 · 2025-06-13T08:17:09.000+01:00
video translation API version
diff --git a/articles/ai-services/speech-service/includes/how-to/video-translation/ai-foundry.md b/articles/ai-services/speech-service/includes/how-to/video-translation/ai-foundry.md
@@ -5,7 +5,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 3/8/2025
+ms.date: 6/13/2025
 ms.custom: references_regions
 ---
 
diff --git a/articles/ai-services/speech-service/includes/how-to/video-translation/rest.md b/articles/ai-services/speech-service/includes/how-to/video-translation/rest.md
@@ -5,7 +5,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 3/8/2025
+ms.date: 6/13/2025
 ms.custom: references_regions
 ---
 
@@ -67,9 +67,10 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" -H "Operati
     "speakerCount": 1,
     "subtitleMaxCharCountPerSegment": 50,
     "exportSubtitleInVideo": false,
+    "enableLipSync": false,
     "videoFileUrl": "https://speechstudioprodpublicsa.blob.core.windows.net/ttsvoice/VideoTranslation/PublicDoc/SampleData/es-ES-TryOutOriginal.mp4"
   }
-}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20-preview"
+}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20"
 ```
 
 > [!IMPORTANT]
@@ -85,7 +86,8 @@ You should receive a response body in the following format:
     "voiceKind": "PlatformVoice",
     "speakerCount": 1,
     "subtitleMaxCharCountPerSegment": 50,
-    "exportSubtitleInVideo": false
+    "exportSubtitleInVideo": false,
+    "enableLipSync": false
   },
   "status": "NotStarted",
   "lastActionDateTime": "2025-03-06T19:13:35.669Z",
@@ -120,7 +122,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" \
     "subtitleMaxCharCountPerSegment": 30,
     "exportSubtitleInVideo": true
   }
-}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-1?api-version=2024-05-20-preview"
+}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-1?api-version=2024-05-20"
 ```
 
 You should receive a response body in the following format:
@@ -147,7 +149,7 @@ You can download the translated video and subtitles once the iteration status is
 To retrieve details of a specific iteration by its ID, use the HTTP GET request. Replace `YourSpeechResourceKey` with your Speech resource key,  `YourSpeechResourceRegion` with your Speech resource region, `Your-Translation-Id` with the translation ID you want to check,  and `Your-Iteration-Id` with the iteration ID you want to check.
 
 ```azurecli-interactive
-curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id?api-version=2024-05-20-preview"  
+curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id?api-version=2024-05-20"  
 ```
 
 You should receive a response body in the following format:
@@ -551,7 +553,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" \
       "url": "https://YourBlobStorageUrl/YourWebVTTFile.vtt"
     }
   }
-}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-2?api-version=2024-05-20-preview"
+}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-2?api-version=2024-05-20"
 ```
 
 You should receive a response body in the following format:
@@ -580,7 +582,7 @@ Check the status of an operation using its operation ID. The operation ID is uni
 - Replace `YourSpeechResourceKey` with your Speech resource key and replace `YourSpeechResourceRegion` with your Speech resource region.
 
 ```azurecli-interactive
-curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/operations/Your-Operation-Id-1?api-version=2024-05-20-preview" 
+curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/operations/Your-Operation-Id-1?api-version=2024-05-20" 
 ```
 
 You should receive a response body in the following format:
@@ -599,7 +601,7 @@ Remove a specific translation identified by `translationId`. This operation also
 Replace `YourSpeechResourceKey` with your Speech resource key,  `YourSpeechResourceRegion` with your Speech resource region, and `Your-Translation-Id` with the translation ID you want to delete. If not deleted manually, the service retains the translation history for up to 31 days.
 
 ```azurecli-interactive
-curl -v -X DELETE -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20-preview" 
+curl -v -X DELETE -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20" 
 ```
 
 The response headers include `HTTP/1.1 204 No Content` if the delete request was successful.
@@ -628,23 +630,23 @@ This section provides examples for other video translation API calls that aren't
 To list all video translations that are uploaded and processed in your resource account, make an HTTP GET request as shown in the following example. Replace `YourSpeechResourceKey` with your Speech resource key and replace `YourSpeechResourceRegion` with your Speech resource region.   
 
 ```azurecli-interactive
-curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations?api-version=2024-05-20-preview"
+curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations?api-version=2024-05-20"
 ```
 
 ### Get a translation by translation ID
 
 This operation retrieves detailed information about a specific translation, identified by its unique `translationId`. Replace `YourSpeechResourceKey` with your Speech resource key,  `YourSpeechResourceRegion` with your Speech resource region, and `Your-Translation-Id` with the translation ID you want to check.
 
 ```azurecli-interactive
-curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20-preview" 
+curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20" 
 ```
 
 ### List iterations
 
 List all iterations for a specific translation. This request lists all iterations without detailed information. Replace `YourSpeechResourceKey` with your Speech resource key,  `YourSpeechResourceRegion` with your Speech resource region, and `Your-Translation-Id` with the translation ID you want to check.
 
 ```azurecli-interactive
-curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations?api-version=2024-05-20-preview"  
+curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations?api-version=2024-05-20"  
 ```
 
 ## HTTP status codes
diff --git a/articles/ai-services/speech-service/includes/how-to/video-translation/speech-studio.md b/articles/ai-services/speech-service/includes/how-to/video-translation/speech-studio.md
@@ -5,7 +5,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 3/8/2025
+ms.date: 6/13/2025
 ms.custom: references_regions
 ---
 
@@ -14,7 +14,7 @@ In this article, you learn how to use video translation with Azure AI Speech in
 ## Pre-requisites
 
 - An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.
-- an AI Foundry resource for Speech [in a supported region](../../../video-translation-overview.md#supported-regions-and-languages). If you don't have a Speech resource, create one in the [Azure portal](https://portal.azure.com/).
+- A Speech resource [in a supported region](../../../video-translation-overview.md#supported-regions-and-languages). If you don't have a Speech resource, create one in the [Azure portal](https://portal.azure.com/).
 - An [Azure Blob Storage](/azure/storage/blobs/storage-blobs-overview) account. 
 - You need a video file in .mp4 format, less than 5 GB, and shorter than 4 hours. For testing purposes, you can use the sample video file provided by Microsoft at [https://speechstudioprodpublicsa.blob.core.windows.net/ttsvoice/VideoTranslation/PublicDoc/SampleData/es-ES-TryOutOriginal.mp4](https://speechstudioprodpublicsa.blob.core.windows.net/ttsvoice/VideoTranslation/PublicDoc/SampleData/es-ES-TryOutOriginal.mp4).
 - Make sure video translation supports your [source and target language](../../../language-support.md?tabs=speech-translation#video-translation).
diff --git a/articles/ai-services/speech-service/toc.yml b/articles/ai-services/speech-service/toc.yml
@@ -225,7 +225,7 @@ items:
          href: get-started-speech-translation.md
        - name: How to recognize and translate speech
          href: how-to-translate-speech.md
-    - name: Video translation (preview)
+    - name: Video translation
       items:
        - name: Video translation overview
          href: video-translation-overview.md
diff --git a/articles/ai-services/speech-service/video-translation-overview.md b/articles/ai-services/speech-service/video-translation-overview.md
@@ -5,17 +5,15 @@ description: With video translation, you can seamlessly integrate multi-language
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 4/15/2025
+ms.date: 6/13/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
 ms.custom: references_regions
 #Customer intent: As a developer, I want to learn about video translation in Azure AI Speech.
 ---
 
-# What is video translation (preview) 
-
-[!INCLUDE [Feature preview](../includes/preview-feature.md)]
+# What is video translation?
 
 Video translation is a feature in Azure AI Speech that enables you to seamlessly translate and generate videos in multiple languages automatically. This feature is designed to help you localize your video content to cater to diverse audiences around the globe. You can efficiently create immersive, localized videos across various use cases such as vlogs, education, news, enterprise training, advertising, film, TV shows, and more.
 
