Merge pull request #269943 from eric-urban/eur/stt-32-preview2

stt 3.2 preview2

Author: JamesJBarnett

articles/ai-services/speech-service/batch-transcription-create.md

@@ -260,18 +260,18 @@ To use a Whisper model for batch transcription, you need to set the `model` prop
 Whisper models by batch transcription are supported in the East US, Southeast Asia, and West Europe regions.
 
 ::: zone pivot="rest-api"
-You can make a [Models_ListBaseModels](https://westus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview1/operations/Models_ListBaseModels) request to get available base models for all locales.
+You can make a [Models_ListBaseModels](https://westus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview2/operations/Models_ListBaseModels) request to get available base models for all locales.
 
 Make an HTTP GET request as shown in the following example for the `eastus` region. Replace `YourSubscriptionKey` with your Speech resource key. Replace `eastus` if you're using a different region.
 
 ```azurecli-interactive
-curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
+curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
 ```
 
 By default, only the 100 oldest base models are returned. Use the `skip` and `top` query parameters to page through the results. For example, the following request returns the next 100 base models after the first 100.
 
 ```azurecli-interactive
-curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base?skip=100&top=100" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
+curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base?skip=100&top=100" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
 ```
 
 ::: zone-end
@@ -280,7 +280,7 @@ curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-pre
 Make sure that you set the [configuration variables](spx-basics.md#create-a-resource-configuration) for a Speech resource in one of the supported regions. You can run the `spx csr list --base` command to get available base models for all locales.
 
 ```azurecli
-spx csr list --base --api-version v3.2-preview.1
+spx csr list --base --api-version v3.2-preview.2
 ```
 
 ::: zone-end
@@ -289,9 +289,9 @@ The `displayName` property of a Whisper model contains "Whisper" as shown in thi
 
 ```json
 {
-  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950",
+  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950",
   "links": {
-    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950/manifest"
+    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950/manifest"
   },
   "properties": {
     "deprecationDates": {
@@ -333,20 +333,20 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
   "locale": "en-US",
   "displayName": "My Transcription",
   "model": {
-    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base/d9cbeee6-582b-47ad-b5c1-6226583c92b6"
+    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/d9cbeee6-582b-47ad-b5c1-6226583c92b6"
   },
   "properties": {
     "wordLevelTimestampsEnabled": true,
   },
-}'  "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/transcriptions"
+}'  "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions"
 ```
 
 ::: zone-end
 
 ::: zone pivot="speech-cli"
 
 ```azurecli
-spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav;https://crbn.us/whatstheweatherlike.wav --model "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base/d9cbeee6-582b-47ad-b5c1-6226583c92b6" --api-version v3.2-preview.1
+spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav;https://crbn.us/whatstheweatherlike.wav --model "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/d9cbeee6-582b-47ad-b5c1-6226583c92b6" --api-version v3.2-preview.2
 ```
 
 ::: zone-end

articles/ai-services/speech-service/migrate-v3-1-to-v3-2.md

@@ -24,7 +24,7 @@ The Speech to text REST API is used for [Batch transcription](batch-transcriptio
 
 ## Base path
 
-You must update the base path in your code from `/speechtotext/v3.1` to `/speechtotext/v3.2-preview.1`. For example, to get base models in the `eastus` region, use `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base` instead of `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base`.
+You must update the base path in your code from `/speechtotext/v3.1` to `/speechtotext/v3.2-preview.2`. For example, to get base models in the `eastus` region, use `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base` instead of `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base`.
 
 For more information, see [Operation IDs](#operation-ids) later in this guide.
 
@@ -57,7 +57,7 @@ Azure AI Speech now supports OpenAI's Whisper model via Speech to text REST API
 
 ### Custom display text formatting
 
-To support model adaptation with [custom display text formatting](how-to-custom-speech-test-and-train.md#custom-display-text-formatting-data-for-training) data, the [Datasets_Create](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview1/operations/Datasets_Create) operation supports the **OutputFormatting** data kind. For more information, see [upload datasets](how-to-custom-speech-upload-data.md#upload-datasets). 
+To support model adaptation with [custom display text formatting](how-to-custom-speech-test-and-train.md#custom-display-text-formatting-data-for-training) data, the [Datasets_Create](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview2/operations/Datasets_Create) operation supports the **OutputFormatting** data kind. For more information, see [upload datasets](how-to-custom-speech-upload-data.md#upload-datasets). 
 
 Added a definition for `OutputFormatType` with `Lexical` and `Display` enum values.
 
@@ -174,15 +174,130 @@ Added token count and token error properties to the `EvaluationProperties` prope
 - `tokenInsertionCount2`: The number of recognized tokens by model2 that are insertions.
 - `tokenSubstitutionCount2`: The number of recognized words by model2 that are substitutions.
 
+
+### Model copy
+
+Added the new `"/operations/models/copy/{id}"` operation. Used for copy models scenario.
+Added the new `"/models/{id}:copy"` operation. Schema in the new copy operation: `"$ref": "#/definitions/ModelCopyAuthorization"` Deprecated the `"/models/{id}:copyto"` operation. Schema in the deprecated copy operation: `"$ref": "#/definitions/ModelCopy"`
+Added the new `"/models:authorizecopy"` operation returns `"$ref": "#/definitions/ModelCopyAuthorization"`. This returned entity can be used in the new `"/models/{id}:copy"` operation.
+
+Added a new entity definition for `ModelCopyAuthorization`:
+
+```json
+"ModelCopyAuthorization": {
+    "title": "ModelCopyAuthorization",
+    "required": [
+        "expirationDateTime",
+        "id",
+        "sourceResourceId",
+        "targetResourceEndpoint",
+        "targetResourceId",
+        "targetResourceRegion"
+    ],
+    "type": "object",
+    "properties": {
+        "targetResourceRegion": {
+            "description": "The region (aka location) of the target speech resource (e.g., westus2).",
+            "minLength": 1,
+            "type": "string"
+        },
+        "targetResourceId": {
+            "description": "The Azure Resource ID of the target speech resource.",
+            "minLength": 1,
+            "type": "string"
+        },
+        "targetResourceEndpoint": {
+            "description": "The endpoint (base url) of the target resource (with custom domain name when it is used).",
+            "minLength": 1,
+            "type": "string"
+        },
+        "sourceResourceId": {
+            "description": "The Azure Resource ID of the source speech resource.",
+            "minLength": 1,
+            "type": "string"
+        },
+        "expirationDateTime": {
+            "format": "date-time",
+            "description": "The expiration date of this copy authorization.",
+            "type": "string"
+        },
+        "id": {
+            "description": "The ID of this copy authorization.",
+            "minLength": 1,
+            "type": "string"
+        }
+    }
+},
+```
+
+Added a new entity definition for `ModelCopyAuthorizationDefinition`:
+
+```json
+"ModelCopyAuthorizationDefinition": {
+    "title": "ModelCopyAuthorizationDefinition",
+    "required": [
+        "sourceResourceId"
+    ],
+    "type": "object",
+    "properties": {
+        "sourceResourceId": {
+            "description": "The Azure Resource ID of the source speech resource.",
+            "minLength": 1,
+            "type": "string"
+        }
+    }
+},
+```
+
+### CustomModelLinks copy properties
+
+Added a new `copy` property.
+copyTo URI: The location to the obsolete model copy action. See operation \"Models_CopyTo\" for more details.
+copy URI: The location to the model copy action. See operation \"Models_Copy\" for more details.
+
+```json
+"CustomModelLinks": {
+    "title": "CustomModelLinks",
+    "type": "object",
+    "properties": {
+      "copyTo": {
+        "format": "uri",
+        "description": "The location to the obsolete model copy action. See operation \"Models_CopyTo\" for more details.",
+        "type": "string",
+        "readOnly": true
+      },
+      "copy": {
+        "format": "uri",
+        "description": "The location to the model copy action. See operation \"Models_Copy\" for more details.",
+        "type": "string",
+        "readOnly": true
+      },
+      "files": {
+        "format": "uri",
+        "description": "The location to get all files of this entity. See operation \"Models_ListFiles\" for more details.",
+        "type": "string",
+        "readOnly": true
+      },
+      "manifest": {
+        "format": "uri",
+        "description": "The location to get a manifest for this model to be used in the on-prem container. See operation \"Models_GetCustomModelManifest\" for more details.",
+        "type": "string",
+        "readOnly": true
+      }
+    },
+    "readOnly": true
+},
+```
+
 ## Operation IDs
 
-You must update the base path in your code from `/speechtotext/v3.1` to `/speechtotext/v3.2-preview.1`. For example, to get base models in the `eastus` region, use `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.1/models/base` instead of `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base`.
+You must update the base path in your code from `/speechtotext/v3.1` to `/speechtotext/v3.2-preview.2`. For example, to get base models in the `eastus` region, use `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base` instead of `https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base`.
 
 
 ## Next steps
 
 * [Speech to text REST API](rest-speech-to-text.md)
-* [Speech to text REST API v3.2 (preview)](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview1)
+* [Speech to text REST API v3.2 (preview)](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview2)
 * [Speech to text REST API v3.1 reference](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-1)
 * [Speech to text REST API v3.0 reference](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-0)
 

articles/ai-services/speech-service/rest-speech-to-text.md

@@ -22,7 +22,7 @@ Speech to text REST API is used for [batch transcription](batch-transcription.md
 > Speech to text REST API v3.0 will be retired on April 1st, 2026. For more information, see the Speech to text REST API [v3.0 to v3.1](migrate-v3-0-to-v3-1.md) and [v3.1 to v3.2](migrate-v3-1-to-v3-2.md) migration guides.
 
 > [!div class="nextstepaction"]
-> [See the Speech to text REST API v3.2 (preview)](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview1)
+> [See the Speech to text REST API v3.2 (preview)](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-2-preview2)
 
 > [!div class="nextstepaction"]
 > [See the Speech to text REST API v3.1 reference documentation](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-1/)