update related files

Author: laujan

articles/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically.md

@@ -183,7 +183,7 @@ The following headers are included with each Document translation API request:
 }
 ```
 
-### Translate text embedded in images within documents 🆕
+### Translate text embedded within images in a document 🆕
 
 > [!Note]
 >
@@ -200,12 +200,59 @@ The following headers are included with each Document translation API request:
    * Data type: Boolean (`true` or `false`) 
    * Default Boolean setting is `false`. Set the option to `true` to enable image text translation.
 
+* Here's a sample JSON request:
+
+  ```json
+  {
+    "inputs": [
+      {
+        "source": {
+          "sourceUrl": "<SAS-URL>",
+          "language": "en"
+        },
+        "targets": [
+          {
+            "targetUrl": "<SAS-URL>",
+            "language": "ta"
+          }
+        ]
+      }
+    ],
+    "options": {
+      "experimental": false,
+      "translateTextWithinImage": true
+    }
+  }
+  ```
+
 * **Response Details**. When the feature is enabled, added image processing information is included with the response: 
 
    * **`totalImageScansSucceeded`**. The number of successfully translated image scans.
 
    * **`totalImageScansFailed`**. The number of image scans that failed processing.
 
+* Here's a sample JSON response:
+
+  ```json
+    {
+        "id": "1a2b0c23-45d6-789-a123-a456fdaf7890",
+        "createdDateTimeUtc": "2024-11-13T22:06:58.2789197Z",
+        "lastActionDateTimeUtc": "2024-11-13T22:07:14.1608283Z",
+        "status": "Running",
+        "summary": {
+            "total": 1,
+            "failed": 0,
+            "success": 0,
+            "inProgress": 1,
+            "notYetStarted": 0,
+            "cancelled": 0,
+            "totalCharacterCharged": 0,
+            "totalImageScansSucceeded": 2,
+            "totalImageScansFailed": 0
+        }
+    }
+  ```
+
 ### Translate documents using a custom glossary
 
 ```json

articles/ai-services/translator/document-translation/overview.md

@@ -5,7 +5,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: overview
-ms.date: 04/14/2025
+ms.date: 06/03/2025
 ms.author: lajanuar
 ms.custom: references_regions
 recommendations: false
@@ -36,6 +36,7 @@ Use asynchronous document processing to translate multiple documents and large f
   | ---------| -------------|
   |**Translate large files**| Translate whole documents asynchronously.|
   |**Translate numerous files**|Translate multiple files across all supported languages and dialects while preserving document structure and data format.|
+  |[**Translate text embedded within images in a document** 🆕](how-to-guides/use-rest-api-programmatically.md#translate-text-embedded-within-images-in-a-document-).| This feature is available with the [batch document translation](how-to-guides/use-rest-api-programmatically.md#translate-text-embedded-within-images-in-a-document-) API for `.docx` file format.|
   |**Preserve source file presentation**| Translate files while preserving the original layout and format.|
   |**Apply custom translation**| Translate documents using general and [custom translation](../custom-translator/concepts/customization.md#azure-ai-custom-translator) models.|
   |**Apply custom glossaries**|Translate documents using custom glossaries.|

articles/ai-services/translator/whats-new.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: overview
-ms.date: 05/29/2025
+ms.date: 06/03/2025
 ms.author: lajanuar
 ---
 <!-- markdownlint-disable MD024 -->
@@ -27,8 +27,8 @@ Azure AI Translator service supports language translation for more than 100 lang
 
 Azure AI Translator [Document translation feature](document-translation/overview.md#batch-key-features) now supports [translating text embedded in images](document-translation/how-to-guides/use-rest-api-programmatically.md#translate-text-embedded-in-images-within-documents-) within documents.
 
-* This is an optional feature and must be enabled for each translation request.
-* Currently, the feature is available only with the [batch document translation](document-translation/how-to-guides/use-rest-api-programmatically.md#translate-text-embedded-in-images-within-documents-) API for `.docx` file format.
+* This feature is optional and must be enabled for each translation request.
+* Currently, the feature is available only with the [batch document translation](document-translation/how-to-guides/use-rest-api-programmatically.md#translate-text-embedded-within-images-in-a-document-) API for `.docx` file format.
 * An [Azure AI Foundry resource](https://portal.azure.com/?Microsoft_Azure_PIMCommon=true#create/Microsoft.CognitiveServicesAIFoundry) (not the standalone Translator resource) is required to use this feature.
 
 ## May 2025