You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> * To use the Translator container, you must submit an online request and have it approved. For more information, *see*[Request container access](overview.md#request-container-access).
24
-
> * Azure AI Translator container supports limited features compared to the cloud offerings.
25
-
26
23
Containers enable you to host the Azure AI Translator API on your own infrastructure. The container image includes all libraries, tools, and dependencies needed to run an application consistently in any private, public, or personal computing environment. If your security or data governance requirements can't be fulfilled by calling Azure AI Translator API remotely, containers are a good option.
27
24
28
25
In this article, learn how to install and run the Translator container online with Docker API. The Azure AI Translator container supports the following operations:
@@ -35,7 +32,7 @@ In this article, learn how to install and run the Translator container online wi
35
32
36
33
## Prerequisites
37
34
38
-
To get started, you need the following resources, access approval, and tools:
35
+
To get started, you need the following resources, gated access approval, and tools:
39
36
40
37
##### Azure resources
41
38
@@ -46,6 +43,9 @@ To get started, you need the following resources, access approval, and tools:
46
43
* An [**Azure AI Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services resource) created under the approved subscription ID. You need the API key and endpoint URI associated with your resource. Both values are required to start the container and can be found on the resource overview page in the Azure portal.
47
44
48
45
* For Translator **connected** containers, select the `S1` pricing tier.
46
+
47
+
:::image type="content" source="media/connected-pricing-tier.png" alt-text="Screenshot of pricing tier selection for Translator connected container.":::
48
+
49
49
* For Translator **disconnected** containers, select **`Commitment tier disconnected containers`** as your pricing tier. You only see the option to purchase a commitment tier if your disconnected container access request is approved.
50
50
51
51
:::image type="content" source="media/disconnected-pricing-tier.png" alt-text="A screenshot showing resource creation on the Azure portal.":::
@@ -96,12 +96,12 @@ The following table describes the minimum and recommended specifications and the
96
96
> [!TIP]
97
97
> You can use the [docker images](https://docs.docker.com/engine/reference/commandline/images/) command to list your downloaded container images. For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:
@@ -151,7 +151,7 @@ To use the latest version of the container, use the latest tag. You can view
151
151
152
152
Select a tab to choose your Azure AI Translator container environment:
153
153
154
-
## [**Connected containers**](#tab/connected)
154
+
### [**Connected containers**](#tab/connected)
155
155
156
156
Azure AI Translator containers enable you to run the Azure AI Translator service `on-premise` in your own environment. Connected containers run locally and send usage information to the cloud for billing.
Copy file name to clipboardExpand all lines: articles/ai-services/translator/containers/overview.md
+8-14Lines changed: 8 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,28 +6,23 @@ author: laujan
6
6
manager: nitinme
7
7
ms.service: azure-ai-translator
8
8
ms.topic: overview
9
-
ms.date: 04/08/2024
9
+
ms.date: 05/02/2024
10
10
ms.author: lajanuar
11
11
---
12
12
13
13
# What is Azure AI Translator container?
14
14
15
-
> [!IMPORTANT]
16
-
>
17
-
> * To use the Translator container, you must submit an online request and have it approved. For more information, *see*[Request container access](#request-container-access).
18
-
> * Azure AI Translator container supports limited features compared to the cloud offerings. For more information, *see*[**Container translate methods**](translator-container-supported-parameters.md).
19
-
20
15
Azure AI Translator container enables you to build translator application architecture that is optimized for both robust cloud capabilities and edge locality. A container is a running instance of an executable software image. The Translator container image includes all libraries, tools, and dependencies needed to run an application consistently in any private, public, or personal computing environment. Containers are isolated, lightweight, portable, and are great for implementing specific security or data governance requirements. Translator container is available in [connected](#connected-containers) and [disconnected (offline)](#disconnected-containers) modalities.
21
16
22
17
## Connected containers
23
18
24
-
***Translator connected container** is deployed on premises and processes content in your environment. It requires internet connectivity to transmit usage metadata for billing; however, your customer content isn't transmitted outside of your premises.
19
+
**Translator connected container** is deployed on premises and processes content in your environment. It requires internet connectivity to transmit usage metadata for billing; however, your content isn't transmitted outside of your premises. The `EULA`, `Billing`, and `APIKey` options must be specified to run a container.
25
20
26
-
You're billed for connected containers monthly, based on the usage and consumption. The container needs to be configured to send metering data to Azure, and transactions are billed accordingly. Queries to the container are billed at the pricing tier of the Azure resource used for the API Key. You're billed for each container instance used to process your documents and images.
21
+
You're billed for connected containers monthly, based on the usage and consumption. Queries to the container are billed at the pricing tier for the Azure resource used for the `APIKey` parameter. For more information, *see*[Billing configuration](configuration.md#billing-configuration-setting).
27
22
28
-
***Sample billing metadata transmitted by Translator connected container***
23
+
***Sample billing metadata for Translator connected container***
29
24
30
-
The `quantity` is the amount you're charged for connected container usage.
25
+
Usage charges are calculated based upon the `quantity` value.
31
26
32
27
```json
33
28
{
@@ -41,13 +36,13 @@ You're billed for connected containers monthly, based on the usage and consumpti
41
36
42
37
## Disconnected containers
43
38
44
-
***Translator disconnected container** is deployed on premises and processes content in your environment. It doesn't require internet connectivity at runtime. Customer must license the container for projected usage over a year and is charged affront.
39
+
**Translator disconnected container** is deployed on premises and processes content in your environment. It doesn't require internet connectivity at runtime. Customer must license the container for projected usage over a year and is charged affront.
45
40
46
41
Disconnected containers are offered through commitment tier pricing offered at a discounted rate compared to pay-as-you-go pricing. With commitment tier pricing, you can commit to using Translator Service features for a fixed fee, at a predictable total cost, based on the needs of your workload. Commitment plans for disconnected containers have a calendar year commitment period.
47
42
48
43
When you purchase a plan, you're charged the full price immediately. During the commitment period, you can't change your commitment plan; however you can purchase more units at a pro-rated price for the remaining days in the year. You have until midnight (UTC) on the last day of your commitment, to end a commitment plan.
49
44
50
-
***Sample billing metadata transmitted by Translator disconnected container***
45
+
***Sample billing metadata for Translator disconnected container***
51
46
52
47
```json
53
48
{
@@ -75,10 +70,9 @@ The aggregated value of `billedUnit` for the following meters is counted toward
Copy file name to clipboardExpand all lines: articles/ai-services/translator/containers/translate-document-parameters.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: "Container: Translate document method"
2
+
title: "Container: Translate document"
3
3
titleSuffix: Azure AI services
4
4
description: Understand the parameters, headers, and body request/response messages for the Azure AI Translator container translate document operation.
5
5
#services: cognitive-services
@@ -26,7 +26,7 @@ ms.author: lajanuar
26
26
`POST` request:
27
27
28
28
```bash
29
-
POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version=2023-11-01-preview" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
29
+
POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
30
30
```
31
31
32
32
Example:
@@ -71,7 +71,7 @@ For this project, you need a source document to translate. You can download our
71
71
Here's an example cURL HTTP request using localhost:5000:
0 commit comments