[VideoTranslation][API Spec] Support GA API version for video translation.

specification/cognitiveservices/Speech.VideoTranslation/client.tsp

@@ -8,6 +8,7 @@ using Azure.ClientGenerator.Core;
 
 @TypeSpec.Versioning.useDependency(Azure.Core.Versions.v1_0_Preview_2)
 @TypeSpec.Versioning.useDependency(
-  Microsoft.Speech.VideoTranslation.ApiVersions.v2024_05_20_preview
+  Microsoft.Speech.VideoTranslation.ApiVersions.v2024_05_20_preview,
+  Microsoft.Speech.VideoTranslation.ApiVersions.v2025_05_20
 )
 namespace Microsoft.Speech.VideoTranslationClient;

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/EventHubConfigurationOperations_CreateOrReplaceEventHubConfiguration.json

@@ -0,0 +1,35 @@
+{
+  "title": "Create or replace EventHub configuration",
+  "operationId": "EventHubConfigurationOperations_CreateOrReplaceEventHubConfiguration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "Ocp-Apim-Subscription-Key": "{API Key}",
+    "body": {
+      "isEnabled": true,
+      "eventHubNamespaceHostName": "your-event-hub-namespace.servicebus.windows.net",
+      "eventHubName": "your-event-hub-name",
+      "managedIdentityClientId": "4b9ccd1c-c751-4afa-a430-a49a5471fd68",
+      "enabledEvents": [
+        "TranslationCompletion",
+        "IterationCompletion"
+      ]
+    },
+    "Content-Type": "application/json"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isEnabled": true,
+        "eventHubNamespaceHostName": "your-event-hub-namespace.servicebus.windows.net",
+        "eventHubName": "your-event-hub-name",
+        "managedIdentityClientId": "4b9ccd1c-c751-4afa-a430-a49a5471fd68",
+        "enabledEvents": [
+          "TranslationCompletion",
+          "IterationCompletion"
+        ]
+      }
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/EventHubConfigurationOperations_DeleteEventHubConfiguration.json

@@ -0,0 +1,14 @@
+{
+  "title": "Delete EventHub config",
+  "operationId": "EventHubConfigurationOperations_DeleteEventHubConfiguration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "Ocp-Apim-Subscription-Key": "{API Key}"
+  },
+  "responses": {
+    "204": {
+      "headers": {}
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/EventHubConfigurationOperations_GetEventHubConfiguration.json

@@ -0,0 +1,24 @@
+{
+  "title": "Get EventHub config",
+  "operationId": "EventHubConfigurationOperations_GetEventHubConfiguration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "Ocp-Apim-Subscription-Key": "{API Key}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isEnabled": true,
+        "eventHubNamespaceHostName": "your-event-hub-namespace.servicebus.windows.net",
+        "eventHubName": "your-event-hub-name",
+        "managedIdentityClientId": "4b9ccd1c-c751-4afa-a430-a49a5471fd68",
+        "enabledEvents": [
+          "TranslationCompletion",
+          "IterationCompletion"
+        ]
+      }
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/EventHubConfigurationOperations_PingEventHub.json

@@ -0,0 +1,16 @@
+{
+  "title": "Send EventHub ping event",
+  "operationId": "EventHubConfigurationOperations_PingEventHub",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "Ocp-Apim-Subscription-Key": "{API Key}",
+    "resource": {},
+    "Content-Type": "application/json"
+  },
+  "responses": {
+    "200": {
+      "headers": {}
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/IterationOperations_CreateIteration.json

@@ -0,0 +1,81 @@
+{
+  "title": "Create Iteration",
+  "operationId": "IterationOperations_CreateIteration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "translationId": "TranslateMyZhCNVideo",
+    "iterationId": "TranslateMyZhCNVideo-ContentEditing-2",
+    "Ocp-Apim-Subscription-Key": "{API Key}",
+    "Operation-Id": "Create-TranslateMyZhCNVideo-ContentEditing-2",
+    "resource": {
+      "description": "Fix segment duration issue and update subtitle max char.",
+      "input": {
+        "enableEmotionalPlatformVoice": "Auto",
+        "speakerCount": 3,
+        "subtitleMaxCharCountPerSegment": 60,
+        "enableVideoSpeedAdjustment": true,
+        "exportTargetLocaleAdvancedSubtitleFile": true,
+        "enableOcrCorrectionFromSubtitle": true,
+        "subtitlePrimaryColor": "ffffff",
+        "webvttFile": {
+          "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+          "kind": "MetadataJson"
+        }
+      }
+    },
+    "Content-Type": "application/json"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Operation-Location": "https://eastus.api.cognitive.microsoft.com/videotranslation/operations/Create-TranslateMyZhCNVideo-ContentEditing-2?api-version=2024-02-01-preview",
+        "Operation-Id": "TranslateMyZhCNVideo-ContentEditing-1"
+      },
+      "body": {
+        "id": "TranslateMyZhCNVideo-ContentEditing-2",
+        "description": "Fix segment duration issue and update subtitle max char.",
+        "status": "NotStarted",
+        "createdDateTime": "2023-04-10T05:30:00.000Z",
+        "lastActionDateTime": "2023-04-10T05:15:30.000Z",
+        "input": {
+          "speakerCount": 3,
+          "subtitleMaxCharCountPerSegment": 60,
+          "enableVideoSpeedAdjustment": true,
+          "exportTargetLocaleAdvancedSubtitleFile": true,
+          "enableOcrCorrectionFromSubtitle": true,
+          "subtitlePrimaryColor": "ffffff",
+          "webvttFile": {
+            "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+            "kind": "MetadataJson"
+          }
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Operation-Location": "https://eastus.api.cognitive.microsoft.com/videotranslation/operations/Create-TranslateMyZhCNVideo-ContentEditing-2?api-version=2024-02-01-preview",
+        "Operation-Id": "TranslateMyZhCNVideo-ContentEditing-1"
+      },
+      "body": {
+        "id": "TranslateMyZhCNVideo-ContentEditing-2",
+        "description": "Fix segment duration issue and update subtitle max char.",
+        "status": "NotStarted",
+        "createdDateTime": "2023-04-10T05:30:00.000Z",
+        "lastActionDateTime": "2023-04-10T05:15:30.000Z",
+        "input": {
+          "speakerCount": 3,
+          "subtitleMaxCharCountPerSegment": 60,
+          "enableVideoSpeedAdjustment": true,
+          "exportTargetLocaleAdvancedSubtitleFile": true,
+          "enableOcrCorrectionFromSubtitle": true,
+          "subtitlePrimaryColor": "ffffff",
+          "webvttFile": {
+            "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+            "kind": "MetadataJson"
+          }
+        }
+      }
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/IterationOperations_GetIteration.json

@@ -0,0 +1,41 @@
+{
+  "title": "Get Iteration",
+  "operationId": "IterationOperations_GetIteration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "translationId": "TranslateMyZhCNVideo",
+    "Ocp-Apim-Subscription-Key": "{API Key}",
+    "iterationId": "TranslateMyZhCNVideo-Iteration-1"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "TranslateMyZhCNVideo-Iteration-1",
+        "description": "Translate video from en-US to zh-CN, fix segment issue.",
+        "status": "Succeeded",
+        "createdDateTime": "2023-04-10T05:30:00.000Z",
+        "lastActionDateTime": "2023-04-10T05:15:30.000Z",
+        "input": {
+          "speakerCount": 3,
+          "subtitleMaxCharCountPerSegment": 60,
+          "enableVideoSpeedAdjustment": true,
+          "exportTargetLocaleAdvancedSubtitleFile": true,
+          "enableOcrCorrectionFromSubtitle": true,
+          "subtitlePrimaryColor": "ffffff",
+          "webvttFile": {
+            "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+            "kind": "MetadataJson"
+          }
+        },
+        "result": {
+          "translatedVideoFileUrl": "https://xxx.blob.core.windows.net/container1/video.mp4?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+          "sourceLocaleSubtitleWebvttFileUrl": "https://xxx.blob.core.windows.net/container1/sourceLocale.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+          "targetLocaleSubtitleWebvttFileUrl": "https://xxx.blob.core.windows.net/container1/targetLocale.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+          "metadataJsonWebvttFileUrl": "https://xxx.blob.core.windows.net/container1/metadataJsonLocale.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx"
+        }
+      }
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/IterationOperations_ListIteration.json

@@ -0,0 +1,69 @@
+{
+  "title": "List Iteration",
+  "operationId": "IterationOperations_ListIteration",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "translationId": "TranslateMyZhCNVideo",
+    "Ocp-Apim-Subscription-Key": "{API Key}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "Initial",
+            "description": "Translate video from en-US to zh-CN, fix segment issue.",
+            "input": {
+              "speakerCount": 3,
+              "subtitleMaxCharCountPerSegment": 60,
+              "enableVideoSpeedAdjustment": true,
+              "exportTargetLocaleAdvancedSubtitleFile": true,
+              "enableOcrCorrectionFromSubtitle": true,
+              "subtitlePrimaryColor": "ffffff",
+              "webvttFile": {
+                "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+                "kind": "MetadataJson"
+              }
+            },
+            "status": "Succeeded",
+            "createdDateTime": "2023-04-10T05:30:00.000Z",
+            "lastActionDateTime": "2023-04-10T05:15:30.000Z"
+          },
+          {
+            "id": "TranslateMyZhCNVideo-Iteration-1",
+            "description": "Translate video from en-US to zh-CN.",
+            "input": {
+              "speakerCount": 3,
+              "subtitleMaxCharCountPerSegment": 80,
+              "webvttFile": {
+                "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+                "kind": "MetadataJson"
+              }
+            },
+            "status": "Failed",
+            "createdDateTime": "2023-04-01T05:30:00.000Z",
+            "lastActionDateTime": "2023-04-10T05:15:30.000Z"
+          },
+          {
+            "id": "TranslateMyZhCNVideo-Iteration-2",
+            "description": "Translate video from en-US to zh-CN.",
+            "input": {
+              "speakerCount": 3,
+              "subtitleMaxCharCountPerSegment": 80,
+              "webvttFile": {
+                "url": "https://xxx.blob.core.windows.net/container1/myvtt.vtt?sv=2023-01-03&st=2024-05-20T08%3A27%3A15Z&se=2024-05-21T08%3A27%3A15Z&sr=b&sp=r&sig=xxx",
+                "kind": "MetadataJson"
+              }
+            },
+            "status": "Running",
+            "createdDateTime": "2023-04-01T05:30:00.000Z",
+            "lastActionDateTime": "2023-04-10T05:15:30.000Z"
+          }
+        ],
+        "nextLink": "https://eastus.api.cognitive.microsoft.com/video-translation/translations/TranslateMyZhCNVideo/iterations?skip=2&maxpagesize=2&api-version=2025-05-20"
+      }
+    }
+  }
+}

specification/cognitiveservices/Speech.VideoTranslation/examples/2025-05-20/OperationOperations_GetOperation.json

@@ -0,0 +1,19 @@
+{
+  "title": "Get Operation",
+  "operationId": "OperationOperations_GetOperation",
+  "parameters": {
+    "Endpoint": "https://eastus.api.cognitive.microsoft.com/",
+    "api-version": "2025-05-20",
+    "operationId": "TranslateMyZhCNVideo-DeleteTranslate",
+    "Ocp-Apim-Subscription-Key": "{API Key}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "TranslateMyZhCNVideo-DeleteTranslate",
+        "status": "Running"
+      }
+    }
+  }
+}