Merge pull request #1499 from MicrosoftDocs/release-ignite-translator-pro

Release ignite translator pro

Author: thomps23

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

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 06/19/2024
+ms.date: 11/19/2024
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp
@@ -22,9 +22,7 @@ ms.custom: mode-other, build-2023, devx-track-extended-java, devx-track-python
 
 > [!NOTE]
 >
-> * Typically, when you create an Azure AI resource in the Azure portal, you have the option to create a multi-service key or a single-service key. However, Document Translation is currently supported in the Translator (single-service) resource only, and is **not** included in the Azure AI services (multi-service) resource.
->
-> * Document Translation is supported in the S1 Standard Service Plan (Pay-as-you-go) and C2, C3, C4, and D3 Volume Discount Plans. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+> Document Translation is supported in the S1 Standard Service Plan (Pay-as-you-go) and C2, C3, C4, and D3 Volume Discount Plans. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 >
 
 To get started, you need:
@@ -36,13 +34,13 @@ To get started, you need:
   * **Source container**. This container is where you upload your files for translation (required).
   * **Target container**. This container is where your translated files are stored (required).
 
-* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services resource):
+* A [**Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation):
 
   **Complete the Translator project and instance details fields as follows:**
 
   1. **Subscription**. Select one of your available Azure subscriptions.
 
-  1. **Resource Group**. You can create a new resource group or add your resource to a pre-existing resource group that shares the same lifecycle, permissions, and policies.
+  1. **Resource Group**. You can create a new resource group or add your resource to an existing resource group that shares the same lifecycle, permissions, and policies.
 
   1. **Resource Region**. Choose **Global** unless your business or application requires a specific region. If you're planning on using a [system-assigned managed identity](create-use-managed-identities.md) for authentication, choose a **geographic** region like **West US**.
 
@@ -212,6 +210,30 @@ The following headers are included with each Document Translation API request:
 }
 ```
 
+### 🆕 Translate text embedded in images within documents
+
+> [!Note]
+>
+> * This feature is optional and must be enabled for each translation request.
+> * Enabling this feature will incur additional costs based on usage. For more information, *see* [Azure AI Vision pricing](https://azure.microsoft.com/pricing/details/cognitive-services/computer-vision/)
+> * This feature is currently available only with the Batch Document Translation API.
+> * The Supported file format is `.docx` only.
+> * An Azure AI Services resource (not the standalone Translator resource) is required to use this feature.
+
+### Request configuration
+
+* Use the optional `translateTextWithinImage` parameter in the `options` field
+
+   * Data type: Boolean (`true` or `false`) 
+   * Default Boolean setting is `false`. Set the option to `true` to enable image text translation.
+
+* **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.
+
+
 ## Use code to submit Document Translation requests
 
 ### Set up your coding Platform
@@ -1279,7 +1301,7 @@ func main() {
 |------------------|-------------|-----------------|
 | 200 | OK | The request was successful. |
 | 400 | Bad Request | A required parameter is missing, empty, or null. Or, the value passed to either a required or optional parameter is invalid. A common issue is a header that is too long. |
-| 401 | Unauthorized | The request isn't authorized. Check to make sure your key or token is valid and in the correct region. When managing your subscription on the Azure portal, make sure you're using the **Translator** single-service resource  _not_ the **Azure AI services** multi-service resource.
+| 401 | Unauthorized | The request isn't authorized. Check to make sure your key or token is valid and in the correct region.
 | 429 | Too Many Requests | You exceeded the quota or rate of requests allowed for your subscription. |
 | 502 | Bad Gateway    | Network or server-side issue. Can also indicate invalid headers. |
 

articles/ai-services/translator/toc.yml

@@ -285,6 +285,15 @@ items:
     - name: Automate text translation (preview)
       displayName: connect, power, automate, flow
       href: connector/text-translator-flow.md
+  - name: Microsoft Translator Pro
+    items:
+    - name: What is Microsoft Translator Pro?
+      displayName: app service, mobile app, ios, speech-to-speech
+      href: translator-pro/overview.md
+    - name: Responsible AI and compliance
+      items:
+      - name: Transparency note
+        href: /legal/cognitive-services/translator/translator-pro-transparency-note?context=/azure/ai-services/translator/context/context
 - name: Responsible AI
   items:
   - name: Transparency note

articles/ai-services/translator/translator-pro/overview.md

@@ -0,0 +1,52 @@
+---
+title: What is Microsoft Translator Pro?
+description: Learn about Microsoft Translator Pro and how it enables speech-to-speech translated conversations within your enterprise ecosystem.
+author: laujan
+ms.author: lajanuar
+manager: nitinme
+ms.service: azure-ai-translator
+ms.topic: overview
+ms.date: 11/19/2024
+ms.custom: FY25Q1-Linter
+---
+
+# What is Microsoft Translator Pro (preview)?
+
+Microsoft Translator Pro is a speech-to-speech translation mobile app that enables users to translate conversations in real time. Translator Pro is designed for enterprises seeking to eliminate language barriers within the workplace by delivering a standalone, native experience within the enterprise ecosystem.
+
+Microsoft Translator Pro is a paid mobile app available on the commercial cloud platform. To use the app, Enterprise users must establish their identities and translator resources within the commercial cloud environment.
+
+  > [!IMPORTANT]
+  >
+  > * To use Microsoft Translator Pro you must complete and submit the [**Microsoft Translator Pro Limited Access**](https://aka.ms/TranslatorProGatingForm) online request form and have it approved for access.
+  >
+
+## Specifications and service limits
+
+* The Microsoft Translator Pro app can be accessed on iOS devices and requires iOS 15 or newer versions.
+
+* Enterprise users must set up identities and translator resources within commercial cloud environments; the app doesn't support hybrid use across these environments. For example, an identity created in the commercial cloud can't be used to access an Azure resource in the government cloud via this app.
+
+* This app operates as a paid offering, necessitating payment before usage.
+
+* The app preview is initially available only to enterprises in the United States that meet certain criteria.
+
+* Offline translation is limited to a select number of languages.
+
+## Core features and capabilities
+
+* **Eliminate language barriers**. Real-time speech-to-speech translation allows seamless communication between individuals speaking different languages.
+
+* **Unified efficient experience**. Both transcription and translation can be viewed or heard simultaneously on a single device, ensuring smooth and efficient conversations.
+
+* **Offline usage capability**. The app's speech-to-speech translation capability can be utilized without an internet connection in limited languages, maintaining productivity without interruption.
+
+* **Full administrator control**. Your enterprise IT administrator has extensive control over the app's deployment and usage within your organization. Administrators can fine-tune settings to manage conversation history, audit trails, and diagnostic logs. Additionally, administrators have the ability to disable history or configure the automatic exportation of the history to cloud storage.
+
+* **Enterprise-grade security**. Microsoft Translator Pro ensures exceptional translation quality paired with robust security features. Recognizing that privacy and security are paramount for your organization, administrators can sign in to the app using organizational credentials. Your organization's conversational data remains entirely protected within your Azure tenant. Not Microsoft or any third parties can access your data.
+
+## Next steps
+
+Use the following link to sign up for and try Microsoft Translator Pro:
+
+[**Microsoft Translator Pro Limited Access**](https://aka.ms/TranslatorProGatingForm)