Merge pull request #4167 from MicrosoftDocs/main

Merged by Learn.Build PR Management system

Author: learn-build-service-prod[bot]

articles/ai-foundry/model-inference/includes/use-image-embeddings/csharp.md

@@ -36,7 +36,7 @@ First, create the client to consume the model. The following code uses an endpoi
 
 
 ```csharp
-EmbeddingsClient client = new EmbeddingsClient(
+ImageEmbeddingsClient client = new ImageEmbeddingsClient(
     new Uri("https://<resource>.services.ai.azure.com/models"),
     new AzureKeyCredential(Environment.GetEnvironmentVariable("AZURE_INFERENCE_CREDENTIAL"))
 );
@@ -51,7 +51,7 @@ BearerTokenAuthenticationPolicy tokenPolicy = new BearerTokenAuthenticationPolic
 
 clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry);
 
-client = new EmbeddingsClient(
+ImageEmbeddingsClient client = new ImageEmbeddingsClient(
     new Uri("https://<resource>.services.ai.azure.com/models"),
     credential,
     clientOptions

articles/ai-foundry/model-inference/includes/use-image-embeddings/javascript.md

@@ -99,7 +99,7 @@ var image_path = "sample1.png";
 var image_data = fs.readFileSync(image_path);
 var image_data_base64 = Buffer.from(image_data).toString("base64");
 
-var response = await client.path("images/embeddings").post({
+var response = await client.path("/images/embeddings").post({
     body: {
         input: [
             {
@@ -120,7 +120,7 @@ The following example shows how to create embeddings that are used to create an
 
 
 ```javascript
-var response = await client.path("/embeddings").post({
+var response = await client.path("/images/embeddings").post({
     body: {
         input: [ { image: image_data_base64 } ],
         input_type: "document",
@@ -133,7 +133,7 @@ When you work on a query to retrieve such a document, you can use the following
 
 
 ```javascript
-var response = await client.path("/embeddings").post({
+var response = await client.path("/images/embeddings").post({
     body: {
         input: [ { image: image_data_base64 } ],
         input_type: "query",

articles/ai-services/openai/how-to/function-calling.md

@@ -40,8 +40,9 @@ At a high level you can break down working with functions into three steps:
 * `gpt-4o` (`2024-11-20`)
 * `gpt-4o-mini` (`2024-07-18`)
 * `gpt-4.5-preview` (`2025-02-27`)
-* `gpt-4.1` (`2025-14-2025`)
-* `gpt-4.1-nano` (`2025-14-2025`)
+* `gpt-4.1` (`2025-04-14`)
+* `gpt-4.1-nano` (`2025-04-14`)
+* `gpt-4.1-mini` (`2025-04-14`)
 
 Support for parallel function was first added in API version [`2023-12-01-preview`](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2023-12-01-preview/inference.json)
 

articles/ai-services/openai/how-to/responses.md

@@ -45,6 +45,7 @@ The responses API is currently available in the following regions:
 - `computer-use-preview`
 - `gpt-4.1` (Version: `2025-04-14`)
 - `gpt-4.1-nano` (Version: `2025-04-14`)
+- `gpt-4.1-mini` (Version: `2025-04-14`)
 
 Not every model is available in the regions supported by the responses API. Check the [models page](../concepts/models.md) for model region availability.
 

articles/ai-services/openai/how-to/structured-outputs.md

@@ -32,7 +32,8 @@ Structured outputs make a model follow a [JSON Schema](https://json-schema.org/o
 - `gpt-4o` version: `2024-08-06`
 - `gpt-4o` version: `2024-11-20`
 - `gpt-4.1` version `2025-04-14`
-- `gpt-4.1-nano` version (`2025-14-2025`)
+- `gpt-4.1-nano` version `2025-04-14`
+- `gpt-4.1-mini` version: `2025-04-14`
 
 ## API support
 

articles/ai-services/openai/quotas-limits.md

@@ -68,6 +68,8 @@ The following sections provide you with a quick guide to the default quotas and
 | `gpt-4.1` (2025-04-14) | Default | 1 M | 1 K |
 | `gpt-4.1-nano` (2025-04-14) | Enterprise Tier | 5 M | 5 K |
 | `gpt-4.1-nano` (2025-04-14) | Default | 1 M | 1 K |
+| `gpt-4.1-mini` (2025-04-14) | Enterprise Tier | 5 M | 5 K |
+| `gpt-4.1-mini` (2025-04-14) | Default | 1 M | 1 K |
 
 
 ## computer-use-preview global standard

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

@@ -16,26 +16,34 @@ In this article, you learn how to use video translation with Azure AI Speech in
 > [!TIP]
 > Try out video translation in the [Azure AI Foundry portal](https://ai.azure.com/) before using the API. Use the [video translation REST API](?pivots=rest-api) to integrate video translation into your applications. For more information about the API, see [Video translation REST API](/rest/api/aiservices/videotranslation/translation-operations/create-translation).
 
+## Prerequisites
+
+- An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.
+- An Azure AI Services 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/).
+- 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).
+
 ## Try out video translation
 
-To try out video translation, follow these steps:
+To try out the video translation demo, follow these steps:
 
 1. Go to the [model catalog in Azure AI Foundry portal](https://ai.azure.com/explore/models). 
 
 1. Enter and search for "Azure-AI-Speech" in the catalog search box.
 
-   :::image type="content" source="../../../media/video-translation/search-model-catalog.png" alt-text="Screenshot of the model catalog in Azure AI Foundry portal." lightbox="../../../media/video-translation/search-model-catalog.png":::
+   :::image type="content" source="../../../media/video-translation/foundry-portal/search-model-catalog.png" alt-text="Screenshot of the model catalog in Azure AI Foundry portal." lightbox="../../../media/video-translation/foundry-portal/search-model-catalog.png":::
 
 1. Select **Azure-AI-Speech** and you're taken to the **Azure-AI-Speech** try out page.
 1. Select **Speech capabilities by scenario** > **Video translation**.
 
-   :::image type="content" source="../../../media/video-translation/capabilities-by-scenario.png" alt-text="Screenshot of filtering Speech service capabilities by scenario." lightbox="../../../media/video-translation/capabilities-by-scenario.png":::
+   :::image type="content" source="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png" alt-text="Screenshot of filtering Speech service capabilities by scenario." lightbox="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png":::
 
 1. Under the **Sample option** to the right, select personal or prebuilt voice.
 
 1. Select the **Play** button to hear the translated audio. Select the original video tab to play the original audio.
 
-   :::image type="content" source="../../../media/video-translation/compare-original-translated.png" alt-text="Screenshot of selecting a voice type on the new project page." lightbox="../../../media/video-translation/compare-original-translated.png":::
+   :::image type="content" source="../../../media/video-translation/foundry-portal/compare-original-translated.png" alt-text="Screenshot of selecting a voice type on the new project page." lightbox="../../../media/video-translation/foundry-portal/compare-original-translated.png":::
 
    The voice type options are:
    - **Prebuilt voice**: The service automatically selects the most suitable prebuilt voice by matching the speaker's voice in the video with prebuilt voices.
@@ -45,6 +53,90 @@ To try out video translation, follow these steps:
    > To use personal voice via the API, you need to apply for [access](https://aka.ms/customneural). 
   
 
+## Create a video translation project
+
+To create a video translation project, follow these steps:
+
+1. Go to the [model catalog in Azure AI Foundry portal](https://ai.azure.com/explore/models). 
+   
+1. Enter and search for "Azure-AI-Speech" in the catalog search box.
+
+   :::image type="content" source="../../../media/video-translation/foundry-portal/search-model-catalog.png" alt-text="Screenshot of the model catalog in Azure AI Foundry portal." lightbox="../../../media/video-translation/foundry-portal/search-model-catalog.png":::
+
+1. Select **Azure-AI-Speech** and you're taken to the **Azure-AI-Speech** try out page.
+1. Select **Speech capabilities by scenario** > **Video translation**.
+
+   :::image type="content" source="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png" alt-text="Screenshot of filtering Speech service capabilities by scenario." lightbox="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png":::
+
+1. Select **My videos** > **Upload video**.
+
+   :::image type="content" source="../../../media/video-translation/foundry-portal/select-upload-video.png" alt-text="Screenshot of selecting the upload video button." lightbox="../../../media/video-translation/foundry-portal/select-upload-video.png":::
+
+1. On the **Upload video** page, select a **Voice type**. 
+
+   :::image type="content" source="../../../media/video-translation/foundry-portal/select-voice-type.png" alt-text="Screenshot of selecting a voice type on the new project page." lightbox="../../../media/video-translation/foundry-portal/select-voice-type.png":::
+   
+   The voice type options are:
+   - **Prebuilt neural voice**: The service automatically selects the most suitable prebuilt voice by matching the speaker's voice in the video with prebuilt voices.
+   - **Personal voice**: Use the personal voice that matches the voice of the speakers in the video. 
+
+   > [!NOTE]
+   > To use personal voice, you need to apply for [access](https://aka.ms/customneural). 
+    
+1. Upload your video file by dragging and dropping the video file or selecting the file manually. The video must be in .mp4 format, less than 5 GB, and shorter than 4 hours.
+   
+1. Provide the **Number of speakers**, **Language of the video**, and **Translate to** language.
+
+1. Select the boxes to acknowledge the pricing information and code of conduct. 
+
+1. Select **Next: Advanced settings** if you want to adjust the advanced settings. 
+
+    :::image type="content" source="../../../media/video-translation/foundry-portal/provide-video-information.png" alt-text="Screenshot of providing video information on the new project page." lightbox="../../../media/video-translation/foundry-portal/provide-video-information.png":::
+
+1. Optionally, you can adjust the following settings:
+
+    - **Lexicon file**: This option allows you to add custom words or phrases that the system should recognize and pronounce correctly. You can create a lexicon file in the [audio content creation tool in the Speech Studio](https://aka.ms/speechstudio) and select it here. 
+    - **Burn subtitles**: This option allows you to add subtitles to the video. The subtitle file can be in WebVTT or JSON format. You can download a sample WebVTT file for your reference by selecting **Download sample VTT file**.
+   
+    :::image type="content" source="../../../media/video-translation/foundry-portal/provide-video-information-advanced.png" alt-text="Screenshot of providing lexicon and subtitle information while creating a new project." lightbox="../../../media/video-translation/foundry-portal/provide-video-information-advanced.png":::
+
+   If you want to use your own subtitle files, select **Subtitle** > **Upload your own**. You can choose to upload either the source subtitle file or the target subtitle file. 
+   - Automatic subtitles: Results in both source and target language subtitles.
+   - Upload source language subtitles: Results in both source and target language subtitles.
+   - Upload target language subtitles: Results in only target language subtitles.
+
+1. Select **Create**.
+
+Once the upload to Azure Blob Storage is complete, you can check the processing status on the project tab.
+
+After the project is created, you can select the project to review detailed settings and make adjustments according to your preferences.
+
+## Check and adjust voice settings
+
+Select **My videos** and you should see a video labeled with **Succeeded** status. 
+
+:::image type="content" source="../../../media/video-translation/foundry-portal/select-succeeded-video.png" alt-text="Screenshot of selecting a successfully translated video." lightbox="../../../media/video-translation/foundry-portal/select-succeeded-video.png":::
+
+Select the video to see the **Translated** and **Original** tabs under **Video**. You can compare the original and translated videos by selecting the corresponding tab. The translated video is generated automatically, and you can play it to check the translation quality. 
+
+:::image type="content" source="../../../media/video-translation/foundry-portal/compare-original-translated-custom.png" alt-text="Screenshot of reviewing details of the translated video." lightbox="../../../media/video-translation/foundry-portal/compare-original-translated-custom.png":::
+
+To the right side of the video, you can view both the original script and the translated script. Hovering over each part of the original script triggers the video to automatically jump to the corresponding segment of the original video, while hovering over each part of the translated script triggers the video to jump to the corresponding translated segment.
+
+You can make multiple changes to the video, including adjusting the voice settings, adding or removing segments, and changing the time frame of the scripts. You're only charged after you select **Apply changes** to apply your changes. You can select **Save** to save work in progress without incurring any charges.
+
+If you encounter segments with an "unidentified" voice name, it might be because the system couldn't accurately detect the voice, especially in situations where speaker voices overlap. In such cases, it's advisable to manually change the voice name.  
+
+:::image type="content" source="../../../media/video-translation/foundry-portal/voice-unidentified.png" alt-text="Screenshot of one segment with unidentified voice name." lightbox="../../../media/video-translation/foundry-portal/voice-unidentified.png":::
+
+## Translate to another language
+
+You can keep the current translation project and translate the original video into another language.
+
+1. Select **My videos** and then select the tile for your video translation. 
+1. Select **+ New language**. 
+1. On the new **Translate to new language** page that appears, choose a new translation language and voice type. Once the video is translated, a new project is automatically created. 
+
 ## Related content
 
 - [Video translation overview](../../../video-translation-overview.md)

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

@@ -14,8 +14,9 @@ The video translation REST API facilitates seamless video translation integratio
 ## Pre-requisites
 
 - An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.
-- 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/).
-- You need a video file in .mp4 format, less than 500 MB, and shorter than 60 minutes. 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).
+- An Azure AI Services 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/).
+- 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).
 
 > [!TIP]
@@ -48,7 +49,7 @@ To create a video translation, you need to construct an HTTP PUT request path an
 - Specify `speakerCount`: The number of speakers in the video. This is an optional parameter, and you can set it to 1 if you're unsure.
 - Specify `subtitleMaxCharCountPerSegment`: The maximum number of characters allowed per subtitle segment. This is an optional parameter, and you can set it to 30 if you're unsure.
 - Specify `exportSubtitleInVideo`: A boolean value indicating whether to export subtitles in the video. This is an optional parameter, and you can set it to `true` if you want to include subtitles in the video.
-- Specify the `videoFileUrl`: The URL of the video file you want to translate. The video must be in .mp4 format, less than 500 MB, and shorter than 60 minutes. You can upload the video to Azure Blob Storage and use the Blob URL. 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).
+- Specify the `videoFileUrl`: The URL of the video file you want to translate. The video must be in .mp4 format, less than 5 GB, and shorter than 4 hours. You can upload the video to Azure Blob Storage and use the Blob URL. 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).
 
 For authentication and authorization, you need to include the following headers and path IDs in your request:
 - Set the `Operation-Id` header: The `Operation-Id` must be unique for each operation, such as creating each iteration. Replace `Your-Operation-Id` with a unique ID for this operation.