Creare una risorsa per Translator

Questo articolo illustra come creare una risorsa Traduttore nel portale di Azure. Traduttore per Azure AI è un servizio di traduzione automatica basato sul cloud che fa parte della famiglia di Servizi di Azure AI. Le risorse di Azure sono istanze di servizi creati. Tutte le richieste API a Servizi di Azure AI richiedono un URL endpoint e una chiave di sola lettura per l'autenticazione dell'accesso.

Prerequisiti

Per iniziare, è necessario un account Azure attivo. Se non è disponibile, è possibile creare una sottoscrizione gratuita di 12 mesi.

Creare la risorsa

Con l'account Azure è possibile accedere al servizio Traduttore tramite due tipi di risorse diversi:

• I tipi di risorse a servizio singolo consentono l'accesso a una chiave API e a un endpoint del servizio singoli.

• I tipi di risorse multiservizio consentono l'accesso a più servizi di Azure AI usando una singola chiave API e un singolo endpoint.

Completare i dettagli del progetto e dell'istanza

Dopo aver deciso il tipo di risorsa da usare per accedere al servizio Traduttore, è possibile immettere i dettagli del progetto e dell'istanza.

1. Sottoscrizione. Selezionare una delle sottoscrizioni di Azure disponibili.

2. Gruppo di risorse. È possibile creare un nuovo gruppo di risorse o aggiungere la risorsa a un gruppo di risorse preesistente che condivide lo stesso ciclo di vita, autorizzazioni e criteri.

3. Area della risorsa. Scegliere Globale a meno che l'azienda o l'applicazione non richieda un'area specifica. Se si prevede di usare la funzionalità Traduzione di documenti con autorizzazione dell'identità gestita, scegliere un'area geografica, ad esempio Stati Uniti orientali.

4. Nome. Immettere un nome per la risorsa. Il nome scelto deve essere univoco in Azure.

   Nota

   Se si usa una funzionalità Translator che richiede un endpoint di dominio personalizzato, ad esempio Traduzione documenti, l'input nel name campo è il parametro del nome di dominio personalizzato per l'endpoint.

Assicurarsi di immettere il valore corretto nel name campo per garantire la funzionalità appropriata.

1. Piano tariffario. Selezionare un piano tariffario che soddisfi le proprie esigenze:

   • A ogni sottoscrizione è associato un piano gratuito.
   • Il piano gratuito offre le stesse caratteristiche e funzionalità dei piani a pagamento e non ha scadenza.
   • Per ogni sottoscrizione è disponibile una sola risorsa di livello gratuito.
   • Traduzione di documenti è supportata nei livelli a pagamento. Language Studio supporta solo i livelli di istanza S1 o D3. Per provare Traduzione di documenti, selezionare il livello di istanza Standard S1.

2. Se è stata creata una risorsa multiservizio, i collegamenti nella parte inferiore della scheda Informazioni di base forniscono documentazione tecnica relativa al funzionamento appropriato del servizio.

3. Selezionare Rivedi e crea.

4. Esaminare le condizioni del servizio e selezionare Crea per distribuire la risorsa.

5. Dopo aver distribuito correttamente la risorsa, selezionare Vai alla risorsa.

Chiavi di autenticazione e URL dell'endpoint

Tutte le richieste API dei servizi di Azure AI richiedono un URL dell'endpoint e una chiave di sola lettura per l'autenticazione.

• Chiavi di autenticazione. La chiave è una stringa univoca che viene passata per ogni richiesta al servizio di traduzione. È possibile passare la chiave tramite un parametro della stringa di query o specificandola nell'intestazione della richiesta HTTP.

• URL dell'endpoint. Usare l'endpoint globale nella richiesta API, a meno che non sia necessaria un'area di Azure o un endpoint personalizzato specifico. Per altre informazioni, vedere URL di base. L'URL dell'endpoint globale è api.cognitive.microsofttranslator.com.

Ottenere le chiavi e l'endpoint di autenticazione

Per autenticare la connessione alla risorsa Translator, è necessaria la chiave e l'endpoint per la risorsa.

1. Dopo la distribuzione della nuova risorsa, selezionare Vai alla risorsa o passare alla pagina della risorsa.
2. Nel riquadro di spostamento a sinistra, in Gestione risorse selezionare Chiavi ed endpoint.
3. Copiare e incollare le chiavi e l'URL dell'endpoint in una posizione comoda, ad esempio Blocco note.

Creare un client di Traduzione testuale

Traduzione testuale supporta sia gli endpoint globali che quelli regionali. Dopo avere ottenuto le chiavi di autenticazione, è necessario creare un'istanza di TextTranslationClientusando AzureKeyCredential per l'autenticazione, per interagire con il servizio Traduzione testuale:

• Per creare TextTranslationClient usando un endpoint di risorse globale, è necessaria la risorsa chiave API:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential);
  

• Per creare TextTranslationClient usando un endpoint di risorse a livello di area, è necessario che la risorsa chiave API e il nome dell'area in cui si trova la risorsa:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
  

Come eliminare una risorsa o un gruppo di risorse

Avviso

L'eliminazione di un gruppo di risorse elimina anche tutte le risorse contenute nel gruppo.

Per eliminare la risorsa:

1. Cercare e selezionare Gruppi di risorse nel portale di Azure e selezionare il gruppo di risorse.
2. Selezionare le risorse da eliminare selezionando la casella di controllo adiacente.
3. Selezionare Elimina dal menu in alto vicino al bordo destro.
4. Immettere Elimina nella finestra di dialogo Elimina risorse.
5. Selezionare Elimina.

Per eliminare il gruppo di risorse:

1. Passare al gruppo di risorse nel portale di Azure.
2. Selezionare Elimina gruppo di risorse nella barra dei menu in alto.
3. Confermare la richiesta di eliminazione immettendo il nome del gruppo di risorse e selezionando Elimina.

Come iniziare a usare le API REST di Azure AI Translator

Questo argomento di avvio rapido illustra come usare il servizio Translator con le API REST.

Introduzione a Traduttore

Passaggi successivi

Altre informazioni sulle funzionalità di Azure AI Translator:

• Traduzione di testi
• Traduzione di documenti
• Traduzione personalizzata