Skip to content

Commit db8aaf5

Browse files
committed
video translation API version
1 parent 8a94a94 commit db8aaf5

File tree

5 files changed

+16
-18
lines changed

5 files changed

+16
-18
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: eric-urban
55
ms.author: eur
66
ms.service: azure-ai-speech
77
ms.topic: include
8-
ms.date: 3/8/2025
8+
ms.date: 6/13/2025
99
ms.custom: references_regions
1010
---
1111

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: eric-urban
55
ms.author: eur
66
ms.service: azure-ai-speech
77
ms.topic: include
8-
ms.date: 3/8/2025
8+
ms.date: 6/13/2025
99
ms.custom: references_regions
1010
---
1111

@@ -69,7 +69,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" -H "Operati
6969
"exportSubtitleInVideo": false,
7070
"videoFileUrl": "https://speechstudioprodpublicsa.blob.core.windows.net/ttsvoice/VideoTranslation/PublicDoc/SampleData/es-ES-TryOutOriginal.mp4"
7171
}
72-
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20-preview"
72+
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id?api-version=2024-05-20"
7373
```
7474

7575
> [!IMPORTANT]
@@ -120,7 +120,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" \
120120
"subtitleMaxCharCountPerSegment": 30,
121121
"exportSubtitleInVideo": true
122122
}
123-
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-1?api-version=2024-05-20-preview"
123+
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-1?api-version=2024-05-20"
124124
```
125125

126126
You should receive a response body in the following format:
@@ -147,7 +147,7 @@ You can download the translated video and subtitles once the iteration status is
147147
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.
148148

149149
```azurecli-interactive
150-
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"
150+
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"
151151
```
152152

153153
You should receive a response body in the following format:
@@ -551,7 +551,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" \
551551
"url": "https://YourBlobStorageUrl/YourWebVTTFile.vtt"
552552
}
553553
}
554-
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-2?api-version=2024-05-20-preview"
554+
}' "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations/Your-Translation-Id/iterations/Your-Iteration-Id-2?api-version=2024-05-20"
555555
```
556556

557557
You should receive a response body in the following format:
@@ -580,7 +580,7 @@ Check the status of an operation using its operation ID. The operation ID is uni
580580
- Replace `YourSpeechResourceKey` with your Speech resource key and replace `YourSpeechResourceRegion` with your Speech resource region.
581581

582582
```azurecli-interactive
583-
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"
583+
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"
584584
```
585585

586586
You should receive a response body in the following format:
@@ -599,7 +599,7 @@ Remove a specific translation identified by `translationId`. This operation also
599599
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.
600600

601601
```azurecli-interactive
602-
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"
602+
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"
603603
```
604604

605605
The response headers include `HTTP/1.1 204 No Content` if the delete request was successful.
@@ -628,23 +628,23 @@ This section provides examples for other video translation API calls that aren't
628628
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.
629629

630630
```azurecli-interactive
631-
curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations?api-version=2024-05-20-preview"
631+
curl -v -X GET -H "Ocp-Apim-Subscription-Key: YourSpeechResourceKey" "https://YourSpeechResourceRegion.api.cognitive.microsoft.com/videotranslation/translations?api-version=2024-05-20"
632632
```
633633

634634
### Get a translation by translation ID
635635

636636
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.
637637

638638
```azurecli-interactive
639-
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"
639+
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"
640640
```
641641

642642
### List iterations
643643

644644
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.
645645

646646
```azurecli-interactive
647-
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"
647+
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"
648648
```
649649

650650
## HTTP status codes

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: eric-urban
55
ms.author: eur
66
ms.service: azure-ai-speech
77
ms.topic: include
8-
ms.date: 3/8/2025
8+
ms.date: 6/13/2025
99
ms.custom: references_regions
1010
---
1111

@@ -14,7 +14,7 @@ In this article, you learn how to use video translation with Azure AI Speech in
1414
## Pre-requisites
1515

1616
- An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.
17-
- 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/).
17+
- 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/).
1818
- An [Azure Blob Storage](/azure/storage/blobs/storage-blobs-overview) account.
1919
- 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).
2020
- Make sure video translation supports your [source and target language](../../../language-support.md?tabs=speech-translation#video-translation).

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,7 @@ items:
225225
href: get-started-speech-translation.md
226226
- name: How to recognize and translate speech
227227
href: how-to-translate-speech.md
228-
- name: Video translation (preview)
228+
- name: Video translation
229229
items:
230230
- name: Video translation overview
231231
href: video-translation-overview.md

articles/ai-services/speech-service/video-translation-overview.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,15 @@ description: With video translation, you can seamlessly integrate multi-language
55
manager: nitinme
66
ms.service: azure-ai-speech
77
ms.topic: overview
8-
ms.date: 4/15/2025
8+
ms.date: 6/13/2025
99
ms.reviewer: eur
1010
ms.author: eur
1111
author: eric-urban
1212
ms.custom: references_regions
1313
#Customer intent: As a developer, I want to learn about video translation in Azure AI Speech.
1414
---
1515

16-
# What is video translation (preview)
17-
18-
[!INCLUDE [Feature preview](../includes/preview-feature.md)]
16+
# What is video translation?
1917

2018
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.
2119

0 commit comments

Comments
 (0)