Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Traduzione in tempo reale
Amazon Translate fornisce operazioni di traduzione di documenti e testi in tempo reale che restituiscono immediatamente le traduzioni. Puoi utilizzare la console o l'API per eseguire traduzioni in tempo reale.
**Topics**
+ [Traduzione in tempo reale tramite la console](sync-console.md)
+ [Traduzione in tempo reale tramite l'API](sync-api.md)
# Traduzione in tempo reale tramite la console
Per utilizzare la console per le traduzioni in tempo reale, incolla il testo di input nella casella di testo **Lingua di origine** o fornisci il testo di input come file. Facoltativamente, puoi impostare funzionalità come il livello di formalità desiderato, il mascheramento delle parolacce, la brevità e la terminologia personalizzata.
Puoi utilizzare il rilevamento automatico della lingua con traduzioni in tempo reale, ma potresti incorrere in un addebito. Per ulteriori informazioni, consulta [Rilevamento automatico della lingua](how-it-works.md#how-to-auto).
**Topics**
+ [Traduci testo](#sync-console-text)
+ [Tradurre un documento](#sync-console-document)
+ [Visualizza dati equivalenti di richiesta e risposta API](#sync-console-output)
+ [Usa le funzionalità di traduzione](#sync-console-features)
## Traduci testo
Usa la console Amazon Translate per tradurre fino a 10.000 byte di testo.
1. Apri la [console Amazon Translate](https://console.aws.amazon.com/translate/home).
1. Nel menu di navigazione a sinistra, scegli **Traduzione in tempo reale**.
1. Per **Lingua di origine**, seleziona la lingua del testo sorgente o mantieni il valore su **Auto** per il rilevamento automatico.
1. Per **Lingua di destinazione**, seleziona una lingua.
1. Inserisci o incolla il testo nella casella di testo **Lingua di origine**. La console visualizza il testo tradotto nella casella di testo **Lingua di destinazione**.
![\[La pagina di traduzione del testo della console Amazon Translate.\]](http://docs.aws.amazon.com/it_it/translate/latest/dg/images/gs-10.png)
## Tradurre un documento
La traduzione di documenti in tempo reale supporta le traduzioni dall'inglese a qualsiasi lingua supportata e da qualsiasi lingua supportata all'inglese.
Per tradurre un documento utilizzando la console Amazon Translate:
1. Apri la [console Amazon Translate](https://console.aws.amazon.com/translate/home).
1. Nel menu di navigazione a sinistra, scegli **Traduzione in tempo reale**.
1. Nel pannello Traduzione, scegli la scheda **Documenti**.
![\[La schermata di traduzione del documento della console Amazon Translate.\]](http://docs.aws.amazon.com/it_it/translate/latest/dg/images/gs-12.png)
1. Per **Lingua di origine**, seleziona la lingua del testo sorgente o seleziona **Auto** per il rilevamento automatico.
1. Per **Lingua di destinazione**, seleziona una lingua. Se la lingua di origine non è l'inglese, è necessario selezionare l'inglese come lingua di destinazione.
1. In **Carica file**, scegli **Scegli file** e inserisci il percorso del file sorgente. La dimensione massima del file è 100 KB.
1. Per **Tipo di documento**, seleziona il formato del file sorgente della traduzione. La traduzione di documenti supporta file di input in formato testo semplice, HTML o Word (.docx).
1. Scegli **Translate**.
Al termine dell'attività di traduzione, scegli **Scarica traduzione** per scaricare il documento tradotto sul tuo disco rigido locale. Il formato del documento tradotto (testo, HTML o Word) corrisponde al documento di input.
## Visualizza dati equivalenti di richiesta e risposta API
Dopo aver utilizzato la console per tradurre il testo o il documento di input, puoi visualizzare i dati equivalenti di richiesta API e i dati di risposta in formato JSON.
1. Sotto il pannello **Traduzione**, espandi il pannello di **integrazione dell'applicazione**.
La console visualizza i dati equivalenti della richiesta di traduzione in formato JSON.
![\[Esempi di codice JSON per la traduzione di testo.\]](http://docs.aws.amazon.com/it_it/translate/latest/dg/images/gs-20.png)
1. Puoi copiare la **richiesta JSON** da utilizzare in un'operazione [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)o [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)API.
1. L'output JSON nel **pannello di risposta JSON** corrisponde all'output generato dall'API.
## Usa le funzionalità di traduzione
Per utilizzare le funzionalità di traduzione con la console Amazon Translate:
1. Apri la [console Amazon Translate](https://console.aws.amazon.com/translate/home).
1. Nel menu di navigazione a sinistra, scegli **Traduzione in tempo reale**.
1. Fornisci la lingua di origine, la lingua di destinazione e i dati di input (testo o documento) come descritto nelle procedure precedenti.
1. In **Impostazioni aggiuntive**, puoi scegliere di personalizzare l'output del tuo lavoro di traduzione con le seguenti impostazioni:
**Terminologia personalizzata**
Seleziona un file terminologico personalizzato. Se il file contiene una voce per un termine di origine nel testo di input, Amazon Translate utilizza la traduzione dal file terminologico.
Per ulteriori informazioni, consulta [Personalizzazione delle traduzioni con una terminologia personalizzata](how-custom-terminology.md).
**Brevità**
Riduce la lunghezza dell'output di traduzione per la maggior parte delle traduzioni (rispetto all'output di traduzione senza brevità). Amazon Translate supporta la brevità per la traduzione del testo, ma non per la traduzione di un documento. Amazon Translate ignora l'impostazione della brevità se la lingua di origine e quella di destinazione formano una coppia linguistica non supportata per la brevità.
Per informazioni sulle lingue supportate, consulta. [Usare la brevità in Amazon Translate](customizing-translations-brevity.md)
**Volgarità**
Maschera parole e frasi profane nel risultato della traduzione. Amazon Translate non supporta il mascheramento delle parolacce in tutte le lingue supportate.
Per ulteriori informazioni, consulta [Mascherare parole e frasi profane in Amazon Translate](customizing-translations-profanity.md).
**Formalità**
Per alcune lingue di destinazione, puoi impostare **Formalità** su formale o informale. Amazon Translate ignora l'impostazione della formalità se la formalità non supporta la lingua di destinazione.
Per ulteriori informazioni, consulta [Impostazione della formalità in Amazon Translate](customizing-translations-formality.md).
1. Per la traduzione dei documenti, scegli **Traduci** per tradurre il documento utilizzando le funzionalità scelte.
Per la traduzione del testo, la console applica la funzionalità di traduzione al testo tradotto quando scegli ciascuna funzionalità.
# Traduzione in tempo reale tramite l'API
Amazon Translate fornisce le seguenti operazioni di traduzione in tempo reale per supportare applicazioni interattive:
+ [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)— traduce un blocco di testo.
+ [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)— traduce il contenuto di un file (testo semplice, HTML o.docx).
Queste operazioni sincrone restituiscono il risultato della traduzione direttamente all'applicazione. Se utilizzi il rilevamento automatico della lingua con queste operazioni, potresti incorrere in un addebito. Per ulteriori informazioni, consulta [Rilevamento automatico della lingua](how-it-works.md#how-to-auto).
## Traduci testo
Usa l'[TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operazione per tradurre un singolo blocco di testo.
### Traduci il testo usando la riga di comando
L'esempio seguente mostra come utilizzare l'[TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operazione dalla riga di comando. L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^).
Nella riga di comando, immetti il comando seguente:
```
aws translate translate-text \
--region region \
--source-language-code "en" \
--target-language-code "es" \
--text "hello, world"
```
Il comando risponde con il seguente codice JSON:
```
{
"TargetLanguageCode": "es",
"TranslatedText": "Hola, mundo",
"SourceLanguageCode": "en"
}
```
### Traduci il testo utilizzando un file JSON
Questo esempio mostra come utilizzare un file JSON per tradurre un blocco di testo più lungo. È possibile specificare la lingua di origine e di destinazione sulla riga di comando oppure specificarle nel file JSON.
**Nota**
Il file JSON di esempio è formattato per garantire la leggibilità. Riformatta il campo `"Text"` per rimuovere le interruzioni di riga.
L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^).
**Per tradurre il testo utilizzando un file JSON**
1. Copiare il testo seguente in un file JSON denominato `translate.json`:
```
{
"Text": "Amazon Translate translates documents between languages in
real time. It uses advanced machine learning technologies
to provide high-quality real-time translation. Use it to
translate documents or to build applications that work in
multiple languages.",
"SourceLanguageCode": "en",
"TargetLanguageCode": "fr"
}
```
1. Nel AWS CLI, esegui il comando seguente:
```
aws translate translate-text \
--region region \
--cli-input-json file://translate.json > translated.json
```
Il comando genera un file JSON contenente il testo JSON seguente:
```
{
"TargetLanguageCode": "fr",
"TranslatedText": "Amazon Translate traduit les documents entre
les langue en temps réel. Il utilise des technologies
avancées d'apprentissage de la machine pour fournir
une traduction en temps réel de haute qualité. Utilisez-le
pour traduire des documents ou pour créer des applications
qui fonctionnent en plusieurs langues.",
"SourceLanguageCode": "en"
}
```
## Traduci documento
Utilizzate l'[TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operazione per tradurre un documento di testo, HTML o Word (.docx) e restituite il risultato della traduzione direttamente all'applicazione.
La traduzione di documenti in tempo reale supporta le traduzioni dall'inglese a qualsiasi lingua supportata e da qualsiasi lingua supportata all'inglese. È possibile specificare il codice della lingua sorgente o utilizzare il rilevamento automatico.
### Traduci il documento usando la riga di comando
L'esempio seguente mostra come utilizzare l'[TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operazione dalla riga di comando. L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^).
Nella riga di comando, immetti il comando seguente:
```
aws translate translate-document \
--region region \
--source-language-code "en" \
--target-language-code "es" \
--document-content fileb://source-lang.txt
--document ContentType=text/plain
--query "TranslatedDocument.Content"
--output text | base64
--decode > target-lang.txt
```
Il comando risponde con il seguente codice JSON:
```
{
"SourceLanguageCode": "en",
"TargetLanguageCode": "es",
"TranslatedDocument":{
"Content": blob
}
}
```