https://github.com/alexalvess/poc-text-translation

https://github.com/alexalvess/poc-text-translation

Last synced: 8 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/alexalvess/poc-text-translation
• Owner: alexalvess
• Created: 2022-05-20T17:17:33.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-20T17:18:28.000Z (over 3 years ago)
• Last Synced: 2024-12-31T10:29:48.171Z (9 months ago)
• Language: C#
• Size: 113 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
## POC Translations

This project is a Prove of Concept to show how can we use Translation Service of Azure Cognitive Service to translate some text.

### Provision the service ☁

That is very simple to create. Just into our resource and click to create a Translation Service, like this:

![translation-service](./imgs/create-translate-service.png)

Then we just need to inform the Subscription, Region, and Name of our service.

### Show me the code! 👨‍💻

First we need to get all the necessary credentials:

#### Configure the credentials

First let's get the region information. For it, you can go on the Service Overview and get to show the JSON View:

![location-json-view](./imgs/resource-json-view.png)

And then, we get the location field:

![location-json-view](./imgs/location-json-view.png)

Next we need the key, and URL:

![keys](./imgs/keys.png)

#### In the project

First, let's define the fields that we will use, in "appsettings.json" file:

```json

{

  "TextTranslationHttpClientOptions": {

    "BaseAddress": "https://api.cognitive.microsofttranslator.com",

    "TranslateEndpoint": "/translate",

    "Key": "",

    "Region": "eastus2",

    "ApiVersion": "3.0",

    "From": "pt",

    "To": [ "en" ]

  }

}

```

Then we need just configure the HttpClient to consume this service. For it, we can just inject this dependency like this:

```csharp

...

services

    .AddHttpClient()

    .ConfigureHttpClient((provider, client) =>

    {

        var options = provider.GetRequiredService>().Value;

        client.BaseAddress = new(options.BaseAddress);

        client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", options.Key);

        client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Region", options.Region);

    });

...

And use it!

```

### Costs

![costs-en-us](./imgs/costs-en-us.png)

![costs-pt-br](./imgs/costs-pt-br.png)

---

#### References

* https://docs.microsoft.com/en-us/azure/cognitive-services/translator/quickstart-translator?tabs=csharp

* https://azure.microsoft.com/pt-br/pricing/details/cognitive-services/