Merge pull request #278101 from ForrestGumb/patch-15

Update Custom Voice API version in rest.md

Author: v-dirichards

articles/ai-services/speech-service/includes/how-to/professional-voice/create-consent/rest.md

@@ -11,7 +11,7 @@ ms.custom: include
 
 With the professional voice feature, it's required that every voice be created with explicit consent from the user. A recorded statement from the user is required acknowledging that the customer (Azure AI Speech resource owner) will create and use their voice.
 
-To add voice talent consent to the professional voice project, you get the prerecorded consent audio file from a publicly accessible URL ([Consents_Create](/rest/api/speechapi/consents/create)) or upload the audio file ([Consents_Post](/rest/api/speechapi/consents/post)). In this article, you add consent from a URL. 
+To add voice talent consent to the professional voice project, you get the prerecorded consent audio file from a publicly accessible URL ([Consents_Create](/rest/api/aiservices/speechapi/consents/create)) or upload the audio file ([Consents_Post](/rest/api/aiservices/speechapi/consents/post)). In this article, you add consent from a URL. 
 
 ## Consent statement
 
@@ -25,15 +25,15 @@ You can get the consent statement text for each locale from the text to speech G
 
 ## Add consent from a URL
 
-To add consent to a professional voice project from the URL of an audio file, use the [Consents_Create](/rest/api/speechapi/consents/create) operation of the custom voice API. Construct the request body according to the following instructions:
+To add consent to a professional voice project from the URL of an audio file, use the [Consents_Create](/rest/api/aiservices/speechapi/consents/create) operation of the custom voice API. Construct the request body according to the following instructions:
 
 - Set the required `projectId` property. See [create a project](../../../../professional-voice-create-project.md).
 - Set the required `voiceTalentName` property. The voice talent name can't be changed later.
 - Set the required `companyName` property. The company name can't be changed later.
 - Set the required `audioUrl` property. The URL of the voice talent consent audio file. Use a URI with the [shared access signatures (SAS)](/azure/storage/common/storage-sas-overview) token.
 - Set the required `locale` property. This should be the locale of the consent. The locale can't be changed later. You can find the text to speech locale list [here](/azure/ai-services/speech-service/language-support?tabs=tts).
 
-Make an HTTP PUT request using the URI as shown in the following [Consents_Create](/rest/api/speechapi/consents/create) example. 
+Make an HTTP PUT request using the URI as shown in the following [Consents_Create](/rest/api/aiservices/speechapi/consents/create) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `JessicaConsentId` with a consent ID of your choice. The case sensitive ID will be used in the consent's URI and can't be changed later. 
@@ -46,7 +46,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type:
   "companyName": "Contoso",
   "audioUrl": "https://contoso.blob.core.windows.net/public/jessica-consent.wav?mySasToken",
   "locale": "en-US"
-} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/consents/JessicaConsentId?api-version=2023-12-01-preview"
+} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/consents/JessicaConsentId?api-version=2024-02-01-preview"
 ```
 
 You should receive a response body in the following format:
@@ -65,10 +65,10 @@ You should receive a response body in the following format:
 }
 ```
 
-The response header contains the `Operation-Location` property. Use this URI to get details about the [Consents_Create](/rest/api/speechapi/consents/create) operation. Here's an example of the response header:
+The response header contains the `Operation-Location` property. Use this URI to get details about the [Consents_Create](/rest/api/aiservices/speechapi/consents/create) operation. Here's an example of the response header:
 
 ```HTTP 201
-Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/070f7986-ef17-41d0-ba2b-907f0f28e314?api-version=2023-12-01-preview
+Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/070f7986-ef17-41d0-ba2b-907f0f28e314?api-version=2024-02-01-preview
 Operation-Id: 070f7986-ef17-41d0-ba2b-907f0f28e314
 ```
 

articles/ai-services/speech-service/includes/how-to/professional-voice/create-project/rest.md

@@ -15,12 +15,12 @@ Each project is specific to a country/region and language, and the gender of the
 
 ## Create a project
 
-To create a professional voice project, use the [Projects_Create](/rest/api/speechapi/projects/create) operation of the custom voice API. Construct the request body according to the following instructions:
+To create a professional voice project, use the [Projects_Create](/rest/api/aiservices/speechapi/projects/create) operation of the custom voice API. Construct the request body according to the following instructions:
 
 - Set the required `kind` property to `ProfessionalVoice`. The kind can't be changed later.
 - Optionally, set the `description` property for the project description. The project description can be changed later.
 
-Make an HTTP PUT request using the URI as shown in the following [Projects_Create](/rest/api/speechapi/projects/create) example. 
+Make an HTTP PUT request using the URI as shown in the following [Projects_Create](/rest/api/aiservices/speechapi/projects/create) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `ProjectId` with a project ID of your choice. The case sensitive ID must be unique within your Speech resource. The ID will be used in the project's URI and can't be changed later. 
@@ -29,7 +29,7 @@ Make an HTTP PUT request using the URI as shown in the following [Projects_Creat
 curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type: application/json" -d '{
   "description": "Project description",
   "kind": "ProfessionalVoice"
-} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/projects/ProjectId?api-version=2023-12-01-preview"
+} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/projects/ProjectId?api-version=2024-02-01-preview"
 ```
 
 You should receive a response body in the following format:

articles/ai-services/speech-service/includes/how-to/professional-voice/create-training-set/rest.md

@@ -15,14 +15,14 @@ In this article, you [create a training set](#create-a-training-set) and get its
 
 ## Create a training set
 
-To create a training set, use the [TrainingSets_Create](/rest/api/speechapi/training-sets/create) operation of the custom voice API. Construct the request body according to the following instructions:
+To create a training set, use the [TrainingSets_Create](/rest/api/aiservices/speechapi/training-sets/create) operation of the custom voice API. Construct the request body according to the following instructions:
 
 - Set the required `projectId` property. See [create a project](../../../../professional-voice-create-project.md).
 - Set the required `voiceKind` property to `Male` or `Female`. The kind can't be changed later. 
 - Set the required `locale` property. This should be the locale of the training set data. The locale of the training set should be the same as the locale of the [consent statement](../../../../professional-voice-create-consent.md). The locale can't be changed later. You can find the text to speech locale list [here](/azure/ai-services/speech-service/language-support?tabs=tts).
 - Optionally, set the `description` property for the training set description. The training set description can be changed later.
 
-Make an HTTP PUT request using the URI as shown in the following [TrainingSets_Create](/rest/api/speechapi/training-sets/create) example. 
+Make an HTTP PUT request using the URI as shown in the following [TrainingSets_Create](/rest/api/aiservices/speechapi/training-sets/create) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `JessicaTrainingSetId` with a training set ID of your choice. The case sensitive ID will be used in the training set's URI and can't be changed later. 
@@ -33,7 +33,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type:
   "projectId": "ProjectId",
   "locale": "en-US",
   "voiceKind": "Female"
-} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/trainingsets/JessicaTrainingSetId?api-version=2023-12-01-preview"
+} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/trainingsets/JessicaTrainingSetId?api-version=2024-02-01-preview"
 ```
 
 You should receive a response body in the following format:
@@ -53,7 +53,7 @@ You should receive a response body in the following format:
 
 ## Upload training set data
 
-To upload a training set of audio and scripts, use the [TrainingSets_UploadData](/rest/api/speechapi/training-sets/upload-data) operation of the custom voice API.
+To upload a training set of audio and scripts, use the [TrainingSets_UploadData](/rest/api/aiservices/speechapi/training-sets/upload-data) operation of the custom voice API.
 
 Before calling this API, please store recording and script files in Azure Blob. In the example below, recording files are https://contoso.blob.core.windows.net/voicecontainer/jessica300/*.wav, script files are
 https://contoso.blob.core.windows.net/voicecontainer/jessica300/*.txt. 
@@ -70,7 +70,7 @@ Construct the request body according to the following instructions:
   - Set the required `extensions` property to the extensions of the script files.
   - Optionally, set the `prefix` property to set a prefix for the blob name.
 
-Make an HTTP POST request using the URI as shown in the following [TrainingSets_UploadData](/rest/api/speechapi/training-sets/upload-data) example. 
+Make an HTTP POST request using the URI as shown in the following [TrainingSets_UploadData](/rest/api/aiservices/speechapi/training-sets/upload-data) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `JessicaTrainingSetId` if you specified a different training set ID in the previous step.
@@ -92,13 +92,13 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type
       ".txt"
     ]
   }
-} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/trainingsets/JessicaTrainingSetId:upload?api-version=2023-12-01-preview"
+} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/trainingsets/JessicaTrainingSetId:upload?api-version=2024-02-01-preview"
 ```
 
-The response header contains the `Operation-Location` property. Use this URI to get details about the [TrainingSets_UploadData](/rest/api/speechapi/training-sets/upload-data) operation. Here's an example of the response header:
+The response header contains the `Operation-Location` property. Use this URI to get details about the [TrainingSets_UploadData](/rest/api/aiservices/speechapi/training-sets/upload-data) operation. Here's an example of the response header:
 
 ```HTTP 201
-Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2023-12-01-preview
+Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
 Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345
 ```
 

articles/ai-services/speech-service/includes/how-to/professional-voice/deploy-endpoint/rest.md

@@ -16,13 +16,13 @@ After you've successfully created and [trained](../../../../professional-voice-t
 
 ## Add a deployment endpoint
 
-To create an endpoint, use the [Endpoints_Create](/rest/api/speechapi/endpoints/create) operation of the custom voice API. Construct the request body according to the following instructions:
+To create an endpoint, use the [Endpoints_Create](/rest/api/aiservices/speechapi/endpoints/create) operation of the custom voice API. Construct the request body according to the following instructions:
 
 - Set the required `projectId` property. See [create a project](../../../../professional-voice-create-project.md).
 - Set the required `modelId` property. See [train a voice model](../../../../professional-voice-train-voice.md).
 - Set the required `description` property. The description can be changed later.
 
-Make an HTTP PUT request using the URI as shown in the following [Endpoints_Create](/rest/api/speechapi/endpoints/create) example. 
+Make an HTTP PUT request using the URI as shown in the following [Endpoints_Create](/rest/api/aiservices/speechapi/endpoints/create) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `EndpointId` with an endpoint ID of your choice. The ID must be a GUID and must be unique within your Speech resource. The ID will be used in the project's URI and can't be changed later. 
@@ -32,7 +32,7 @@ curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type:
   "description": "Endpoint for Jessica voice",
   "projectId": "ProjectId",
   "modelId": "JessicaModelId",
-} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/EndpointId?api-version=2023-12-01-preview"
+} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/EndpointId?api-version=2024-02-01-preview"
 ```
 
 You should receive a response body in the following format:
@@ -52,10 +52,10 @@ You should receive a response body in the following format:
 }
 ```
 
-The response header contains the `Operation-Location` property. Use this URI to get details about the [Endpoints_Create](/rest/api/speechapi/endpoints/create) operation. Here's an example of the response header:
+The response header contains the `Operation-Location` property. Use this URI to get details about the [Endpoints_Create](/rest/api/aiservices/speechapi/endpoints/create) operation. Here's an example of the response header:
 
 ```HTTP 201
-Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2023-12-01-preview
+Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
 Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345
 ```
 
@@ -83,15 +83,15 @@ To use a custom voice via [Speech Synthesis Markup Language (SSML)](../../../../
 
 You can suspend or resume an endpoint, to limit spend and conserve resources that aren't in use. You won't be charged while the endpoint is suspended. When you resume an endpoint, you can continue to use the same endpoint URL in your application to synthesize speech. 
 
-To suspend an endpoint, use the [Endpoints_Suspend](/rest/api/speechapi/endpoints/suspend) operation of the custom voice API. 
+To suspend an endpoint, use the [Endpoints_Suspend](/rest/api/aiservices/speechapi/endpoints/suspend) operation of the custom voice API. 
 
-Make an HTTP POST request using the URI as shown in the following [Endpoints_Suspend](/rest/api/speechapi/endpoints/suspend) example. 
+Make an HTTP POST request using the URI as shown in the following [Endpoints_Suspend](/rest/api/aiservices/speechapi/endpoints/suspend) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `YourEndpointId` with the endpoint ID that you received when you created the endpoint.
 
 ```azurecli-interactive
-curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:suspend?api-version=2023-12-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"
+curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:suspend?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"
 ```
 
 You should receive a response body in the following format:
@@ -113,15 +113,15 @@ You should receive a response body in the following format:
 
 ## Resume an endpoint
 
-To suspend an endpoint, use the [Endpoints_Resume](/rest/api/speechapi/endpoints/resume) operation of the custom voice API. 
+To suspend an endpoint, use the [Endpoints_Resume](/rest/api/aiservices/speechapi/endpoints/resume) operation of the custom voice API. 
 
-Make an HTTP POST request using the URI as shown in the following [Endpoints_Resume](/rest/api/speechapi/endpoints/resume) example. 
+Make an HTTP POST request using the URI as shown in the following [Endpoints_Resume](/rest/api/aiservices/speechapi/endpoints/resume) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `YourEndpointId` with the endpoint ID that you received when you created the endpoint.
 
 ```azurecli-interactive
-curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:resume?api-version=2023-12-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"
+curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:resume?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"
 ```
 
 You should receive a response body in the following format:
@@ -143,15 +143,15 @@ You should receive a response body in the following format:
 
 ## Delete an endpoint
 
-To delete an endpoint, use the [Endpoints_Delete](/rest/api/speechapi/endpoints/delete) operation of the custom voice API. 
+To delete an endpoint, use the [Endpoints_Delete](/rest/api/aiservices/speechapi/endpoints/delete) operation of the custom voice API. 
 
-Make an HTTP DELETE request using the URI as shown in the following [Endpoints_Delete](/rest/api/speechapi/endpoints/delete) example. 
+Make an HTTP DELETE request using the URI as shown in the following [Endpoints_Delete](/rest/api/aiservices/speechapi/endpoints/delete) example. 
 - Replace `YourResourceKey` with your Speech resource key.
 - Replace `YourResourceRegion` with your Speech resource region.
 - Replace `YourEndpointId` with the endpoint ID that you received when you created the endpoint.
 
 ```azurecli-interactive
-curl -v -X DELETE "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId?api-version=2023-12-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey"
+curl -v -X DELETE "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey"
 ```
 
 You should receive a response header with status code 204.